Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Some mentions in the hardware reference have little value and are not
consistent across other sections. Drop them to improve consistency.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

There are different pages for reference hardware based on the architecture.
Improve the consistency of these pages to improve readability.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Concept documents express an idea or plan on which Apertis is working,
and will shape its future. However, over time plans change and some
concept documents are not longer in the roadmap.

Since the ideas in those documents are still valid and there is value
in keep, them move them to a new "archive" section, so they can still be
accessed without confusing the audience.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

The order of the jumpers on the board and their numbering do not line
up. This was mentioned in warnings on the setup page, but then the
jumper settings were listed incorrectly, even though the images appear
to be correct. Update the jumper link information to be correct.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

Make overview section appear first in the nav menu.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

The current theme sorts sections by the title, which makes it tricky to
highlight particular sections. To make it easier, switch to use the
weight property.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

The platform guide serves as an overview of what Apetis is, highlighting its main
features. For this reason, add references to other important features provided by
Apertis.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

To make it easier for newcomers to understand the QA in Apertis rework
the main page to provide an introduction and rationale.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

Improve the platform guide mentioning the GPL-3 free approach taken
by Apertis.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 9 months ago and Martyn Welch committed 9 months ago

To add additional context to the importance of security updates, add
references to the European Cyber Resilience Act.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

Since platform-guide provides more relevant information for newcomers
make it appear first in the list.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

To make it easier to newcomers to have a high level overview about Apertis
create a new section "overview" to place useful documents.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Dylan Aïssi authored 9 months ago and Walter Lozano committed 9 months ago

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Dylan Aïssi authored 9 months ago and Walter Lozano committed 9 months ago

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Dylan Aïssi authored 9 months ago and Walter Lozano committed 9 months ago

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Dylan Aïssi authored 9 months ago and Walter Lozano committed 9 months ago

Since it's the most active place for Apertis development

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Dylan Aïssi authored 9 months ago and Walter Lozano committed 9 months ago

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Add contact information to handle issues, and specially security related
ones.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

After moving documents add aliases to avoid breaking external links. Also,
while doing that fix the formatting of aliases to be consistent across the
repo.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

To align with other pages update the format of the page metadata.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

Following the same basic idea used for guides and architecture, split
concepts section in subsections.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Walter Lozano authored 10 months ago and Martyn Welch committed 9 months ago

Rename architecture sections created in f8a4333d to make it easier to
find pages.

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Walter Lozano <walter.lozano@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>

Signed-off-by: Dylan Aïssi <dylan.aissi@collabora.com>