In order to make it clear the preferred approach to deal with different
scenarios of licensing issues, add additional tips and examples.

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

When first importing a package, the `Run pipeline` button doesn't appear
in Gitlab's UI and a workaround is needed to trigger the first pipeline.
This commit adds a tip for such situations.

Signed-off-by: Arnaud Ferraris <arnaud.ferraris@collabora.com>

Arnaud Ferraris authored 3 years ago and Emanuele Aina committed 3 years ago

Signed-off-by: Arnaud Ferraris <arnaud.ferraris@collabora.com>

We have release notes for lots of old releases on the website. These are kept
as they show the project has significant history, however a lot of the
information contained in them is likely to be very out of date. Add a warning
to the top of the old releases to note that they are deprecated and remove any
now dead links.

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

A scan of external links has shown numerous places where external links are
broken, fix them.

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

We have external links looking for the API document in designs, which no longer
exists. Add an alias to support this rather than returning 404.

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

A scan of "external" links are showing numerous places where links point to
supposedly Apertis provided content which is now gone. Fix these or remove
links.

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

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Signed-off-by: Arnaud Ferraris <arnaud.ferraris@collabora.com>

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

The v2019 release has reached the end of its support period. It also marks the
point at which we are now fully into the current Apertis release cadence, with
a development, stable and old stable release being supported.

Remove the pointer to the "old old stable" from the main page, the data from
the releases file and the reference to the supported version of Virtual Box.

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

The packages concept came from the old wiki. It more or less duplicates the
content listed in the "Platform APIs and Services" architectural document, but
also lists a number of packages that have long since been removed from Apertis.
Perform a quick tidy up, moving any potentially useful/relevant information to
the architectural document and deleting the packages page.

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

Ritesh Raj Sarraf authored 3 years ago and Martyn Welch committed 3 years ago

Add a link to the dashboard sub-section where we generate and store the
Apertis package indices, per release, in TSV format

Signed-off-by: Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>

Sagar authored 3 years ago and Arikkala Vijeth committed 3 years ago

Signed-off-by: Sagar <SagarKihore.Benani@in.bosch.com>

Update the table listing the GPL-3 deltas from Debian by

- Add additional entries with deltas
- Reword comments to be consistent with the category

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

In an effort to keep deltas due to licensing issues to a minimum
document the current status and propose alternatives for the different
packages involved.

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

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

It is frequently important for device manufacturers to harden the devices that
they produce, in order to ensure that their devices continue to comply with
required regulations and protect against compromise by malicious third parties.

Provide documentation highlighting techniques that can be used to harden an
Apertis based device.

Update dictionary to include words and acronyms wrongly picked up as spelling
mistakes.

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

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

The cgroup-v1 documentation has moved, correct the link.

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

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

The security document states to "see the Multiuser design document" without
providing a link. Add one to aid users.

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

Current SDK images requests to manually setup the Virtual Machine in
VirtualBox, as we're only provinding the disk image (.vdi file).

Support to generate a VirtualBox Appliance image (.ova file) that works
out of the box has been recently added to `apertis-image-recipes`.

Starting Apertis release version `v2022`, SDK images will be uploaded in
OVA format. Let's document that and still keep the previous `.vdi` disk
image setup for old versions reference.

Signed-off-by: Ariel D'Alessandro <ariel.dalessandro@collabora.com>

Ariel D'Alessandro authored 3 years ago and Martyn Welch committed 3 years ago

Currently, Apertis CI pipeline uses scan-copyrights Perl tool to
generate and update the copyright report. However, this is not
documented anywhere in the website, only fossology is mentioned as a
future improvement.

Let's document the current scan-copyrights approach.

Signed-off-by: Ariel D'Alessandro <ariel.dalessandro@collabora.com>

- Move the Wayland evaluation document to concepts, adding a status to show
  it's out-of-date.
- Move the compositors in Wayland document to architecture
- Reinstate some images for the compositors in Wayland document that had been
  lost.

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

Emanuele Aina authored 3 years ago and Martyn Welch committed 3 years ago

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

This demonstrates simple definition of policy roles and a sample policy
script written in Lua.

Signed-off-by: Frédéric Danis <frederic.danis@collabora.com>

Signed-off-by: Emanuele Aina <emanuele.aina@collabora.com>

Fix minor issue that prevent page to be rendered properly.

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

Signed-off-by: Tino Lippold <Tino.Lippold@de.bosch.com>

It seems that quite a few people have added links to the packaging guide,
add in an alias to make sure we catch these when they've not been updated.

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

We are now beginning to use "+apertisX" rather than "coX" for Apertis changes.
Tweak the description of versioning to use this new string.

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

There is a very kernel specific workflow in the component guide, move this to
the kernel specific document where it makes more sense.

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

The workflows in component guide target Apertis maintainers more than
developers, it is also out-of-date in some places. Update this guide and make
it more relevant to non-maintainers in the process.

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

Signed-off-by: mtt2hi <thomas.mittelstaedt@de.bosch.com>

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

The information about the workflows and repository structure is all
jumbled up. Rename and sort the documentation into high-level
information, workflows and repository layout.

Shift more detailed documentation found in this document into more suitable
locations, rewording/adapting as required.

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

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

Start shifting the workflow guid towards a general high level overview of
the Apertis workflow. Add images to make the process easier to understand.

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

Martyn Welch authored 3 years ago and Martyn Welch committed 3 years ago

There are two sections that indirectly point to the packaging guide.
Remove these as they don't really add anything.

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