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

The current theme uses ".URL" in a number of places that is resulting in
the current warning message:

    Page.URL is deprecated and will be removed in a future release. Use .Permalink or .RelPermalink. If what you want is the front matter URL value, use .Params.url

Update the usage of this variable to ".Permalink" to stop the warning
messages being produced.

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

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

The variable ".Hugo" has been deprecated syntax since v0.55. We get a
warning about this each time the site is built:

    Page.Hugo is deprecated and will be removed in a future release. Use the global hugo function.

Tweak the theme to utilise the correct new syntax to remove the errors
making it clearer what is happening when something goes wrong.

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

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

After moving to the latest version of Hugo, we are seeing lots of warnings
as follows:

WARN 2021/03/08 10:11:09 Failed to get translated string for language "en" and ID "postedOnDate": template: :1:13: executing "" at <.Count>: can't evaluate field Count in type string

The fix is trivial, so implement to save these messages from obscuring
actual issues.

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

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

We have been using an old version of hugo in the gitlab registry as the
latest version available at the time this was setup had a show stopping
bug. Update the version of hugo used and switch to the docker image
recommended by the Hugo project as this is potentially easier for those
behind restrictive proxies to access.

Provide a helper script to also make it easier to run Hugo from docker as
a developer and document it. Use the `--rm` option to cause docker to
remove the container once it's exited to avoid them building up and add
`--security-opt label=disable` for those using an SELinux enabled
distribution.

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

The use of custom domain names to access uptimerobot status pages has been
made part of the pro plan. As we don't currently have a pro plan, update
the website to use the direct URL.

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

We have added the new Terms of Use and Privacy Policy to the website and
in-line with the existing policies we state we will give 30 days notice of
change.

Note: These changes will switch to the new policies and should not be
merged until the 6th May 2021.

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

The copyrights document refers to the "Creative Commons
Attribution-ShareAlike 4.0 Unported" license. Provide a link to
the license so that more information about it can be easily
found.

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

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

The Apertis packaging toolchain and pipelines have switched from the
`coX` packaging version suffix to `apertisX` to better distinguish the
work of the Apertis team from more Collabora-specific packages.

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

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

The Apertis packaging toolchain and pipelines have switched from the
`coX` packaging version suffix to `apertisX` to better distinguish the
work of the Apertis team from more Collabora-specific packages.

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

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

The Apertis packaging toolchain and pipelines have switched from the
`coX` packaging version suffix to `apertisX` to better distinguish the
work of the Apertis team from more Collabora-specific packages.

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

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

The Apertis packaging toolchain and pipelines have switched from the
`coX` packaging version suffix to `apertisX` to better distinguish the
work of the Apertis team from more Collabora-specific packages.

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

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

Removing default code highlighting requires us to explicitly mark code we
wish to be highlighted. Tweak howtobuildyourownkernel.md to act as a show
case of how to do this.

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

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

Hugo has a newer set of config options to control highlighting. Use them.

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

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

Hugo has built in support for build time highlighting via Chroma. The
Beautiful Hugo theme is also enabling Highlight.js. Disable Highlight.js
so that we can gain control over the highlighting from the site config.

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

Signed-off-by: Andreas Elvstam Cantner <andreas.elvstam@se.bosch.com>

This commit enables the generation and display of the ToC on all pages
where it's relevant due to the content size.

More pages could have been included but left aside due to inconsistent
use of heading levels leading to rendering/visual glitches.

The pages' content has not been modified, except for the "Terms of use"
page which included a manually-generated ToC.

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

As some of our pages include a lot of content, structured through the
use of headings, it makes sense to include an auto-generated ToC in our
template.

This ToC is only generated for pages including the `toc` boolean
parameter with value `true` in their source header, so it can be enabled
only when really useful.

It only includes elements from heading levels 2 and 3 by default, while
most of our documents are structured by using levels 1 and 2, so this
commit also includes changes to the config file to reflect that.

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

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

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

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

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

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

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

Extended "Apertis integration testing with LAVA" guide with additional
details.

Signed-off-by: Denis Pynkin <denis.pynkin@collabora.com>
Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

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

It can often be instructive to know how old a document is, it can be
surmised that a document written days ago may be more accurate than on
written years ago. to enable users of the website to easily determine this
add the last modification date to each document.

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

Add some pointers for the style that we expect in Markdown submitted for the
Apertis website. These are things that get picked up in review, stating them
upfront may reduce the time needed to review submissions.

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

Improve documentation by providing an example of debos overlay action to
apply customizations to images.

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

A warning was missed whilst implementing the source file link:

    .File.Path on zero object. Wrap it in if or with: {{ with .File }}{{ .Path }}{{ end }}

Update to use the recommended format.

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

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

In order to make it easier for users to discover where to edit the
website, add a link in the page footer pointing to the current page in
GitLab.

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

Arnaud Ferraris authored 3 years ago and Peter Senna Tschudin committed 3 years ago

The "Publishing a single application" section introduces the use of
.flatpakrepo files, which are detailed in the subsequent "Publishing a
repository" section. Moving the latter section before the former
therefore makes more sense.

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

Arnaud Ferraris authored 3 years ago and Peter Senna Tschudin committed 3 years ago

As requested, this commit adds more detailed explanations and
step-by-step commands for creating and installing signed flatpak
applications.

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

It has been dropped in the packaging-tools repository

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

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

One exception case, that of maintaining a package from an independent
upstream source tarball, was documented separately.

This was causing confusion to us all as this content wasn't reflected on
the master page, i.e. Apertis Packaging Guide

This patch just moves the content to the right location

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

Fix double "the" in the OP-TEE document.

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

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

Provide some updates to clarify issues raised by the document review.

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

Starting with Apertis v2022dev2, `Flatpak` is also able to use `Ed25519`
cryptography.

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

The document was written before all communication applications moved to
closed silos, back when XMPP was commonly used. The tradeoffs in the
document no longer apply and the strategy should be revised.

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

Change 'journactl' -> 'journalctl'

Signed-off-by: Andreas Elvstam Cantner <andreas.elvstam@se.bosch.com>

Sjoerd Simons authored 4 years ago and Sjoerd Simons committed 3 years ago

This document tries to outline at a quite high level the types of
devices and scenarious Apertis tends to support to give potential users
a starting point for considering apertis.

For each sections tables are provides with references to more detailed
documentation section to drill into further technical depth.

Update and re-shuffle the existing parts of the apparmor.md guide
to merge the old guide with the new guide:
 - Update summary with new ref links.
 - Reused a few sections but rephrased and updated references.
 - Removed a few, no longer needed, sections.
 - Fix minor formatting

Signed-off-by: Andreas Elvstam Cantner <andreas.elvstam@se.bosch.com>