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

List the steps in the process implemented so far, linking to tools and
output examples.

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

Skip another set of redirects so it's less likely that validating links
makes us fall into rate limiting.

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

Avoid some redirects which makes us incur into rate limiting when
validating links.

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

There's little point in gating all the other jobs on a relatively slow
job as the URL checker, so make it run in parallel with everything else
without blocking anything.

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

Make spotting failures in the output more easy with colored icons.

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

The GNOME wiki is unhappy about our requests, be nice.

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

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

Avoid `Pool is closed` exceptions.

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

Speed up the querying by using a threadpool.

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

We often get DNS resolution or connection failures, try a few time
before giving up.

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

It can be useful to figure out what goes wrong.

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

Print the HTTP status code and the returned exception when checking
each URL, to better understand what went wrong.

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

Not that it makes any sensible difference, but still. :)

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

Spotting the `FAIL` entry in literally thousands of entries is quite
inconvenient, so list the broken URLs again before exiting.

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>

We have *many* of them in the release notes and they are not publicly
accessible anyway.

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

There's little value in testing the links to the test results for
each release note page and since they are quite slow to render let's
skip them.

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

Denis Pynkin authored 3 years ago and Arnaud Ferraris committed 3 years ago

Added Raspberry pi 4 model B into the reference list for Arm64.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

Denis Pynkin authored 3 years ago and Arnaud Ferraris committed 3 years ago

Added description how to setup the RPi 4 board to use
network boot for LAVA.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

Denis Pynkin authored 3 years ago and Arnaud Ferraris committed 3 years ago

Added initial version of Raspberry Pi 4 setup for
developer.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>

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

The functionality provided by main.js is not used in the new/modified theme.
Remove it from the theme.

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

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

GNOME has moved from git to GitLab. The default redirection is assuming
projects have a "master" branch, whereas some are using "main", resulting in a
404.

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

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

The QA area hasn't had any love for a long time. Remove the bits that we don't
use any more or that are superfluous given how the site indexes pages. Add
links to some of the new QA related tools developed for Apertis.

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

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

The Apertis website isn't a blog, switch from the "posts" terminology to
"documents" which is much more inline with what we have on the site.

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

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

The Apertis theme doesn't support social media icons in its footer. Remove the
data.

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

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

We link to the hardware reference page from the home page, as a result this
page is likely to be one which is visited by people generally unfamilar with
Apertis.

We should not promote the use of daily images to those likely to be looking to
evaluate Apertis - they should be using the stable images.

Booting non-SDK images in VirtualBox is not a supported option, so whilst it
works for many images, this is not guaranteed (and the minimal OSTree images
are known not to boot in VirtualBox). Set expectations with regards to running
in this configuration.

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

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

Tweak the information on the homepage to sell Apertis a bit better. Ensure the
links are the best ones that we can provide.

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

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

The theme provides an archetype of a new document to aid adding pages. This is
out of date and doesn't provide the front matter we expect. Modify it to
provide the minimum expected front matter.

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

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

The licensing documentation is linked from the home page, but is a bit of a
mess, with guidance on documenting licensing and information about the Apertis
licensing scanning infrastructure mixed with Apertis licensing policies.

Split out the license scanning documentation into a separate architecture
document. Move the small amount of policy documentation from the applying
licensing document and move to guides.

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

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

The homepage currently uses a very standard layout, which doesn't provide
a very compelling initial impression. Improve the layout to give the
website a more professional feel, as implemented by Jon Wallace but replace
`DIVclass` with distinct shortcodes.

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

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

The Apertis theme uses a shortcode called `DIVclass` to allow
semi-arbitrary CSS to be applied. Simplify this for document writers by
spliting the responsive table functionality (demoed on the bundle spec) as
a separate shortcode.

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

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

Update the configuration to use the newly added custom theme.

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

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

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

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

The components which comprise the application framework are mentioned in many
places in the Apertis website. Make it clear that these components have been
removed as of the v2022dev2 release.

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

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

Because base-files is important as in it contains all the necessary
metadata pertaining to the release, ensure that it is built proper.

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

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>