We have a number of URLs on the website that point to the old wiki. Since
these documents have either moved or we can provide a more direct link,
update the URLs. This will improve our ability to check for broken links.

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

Information about the reference hardware and supported platforms is a bit
jumbled and out of date. Split out the listing of reference hardware by
architecture to avoid having one massive long page. Shift out development
related details.

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

The containers page covers a proof-of-concept implementation of an
OSTree-based LXC container. This work became redundant, with the required
support being removed:

infrastructure/apertis-image-recipes@eb3c133f



As this is no longer viable, remove the page.

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

The touchscreen we currently use is the one shown in the i.MX6 SABRE
Lite picture, the HannStar HSD100PXN1-A00-C11.

It's not currently in stock. The Boundary Devices websites lists a few
more touchscreens, but we haven't validated them and to support them
some U-Boot changes would be needed to tweak the DTB on boot.

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

The virtual machine guidance is scattered over 3 pages, is poorly formatted
and a little out of date.

Check, update and merge the pages to make it more concise and relevant.
Move to it's proper location under `guides`.

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

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

Most of the docs are under the "docs" directory. Whilst the "docs" still
need to be sorted into the new categories, by moving the remaining
document not in this directory into it and patching up links, we can
remove the documentation page. Hugo automatically creates an index page
for us, so this simplifies the website a little with no real loss.

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

We plan to move the concepts from designs.a.o to the website. To lay the
foundations for this move, move documentation that was on the old wiki and
referenced from designs.a.o into `concepts/`. As these were referenced by
the designs, take them to be of equal importance to that information.

Add an index page that briefly describes what the concepts constitute,
basically topics that have been researched but not necessarily
implemented. Fix up any links that pointed to the location of the old
"concept designs".

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

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

In order to ensure a consistent look to the site, always use the same css
for page headings, don't require each section to define it's own css.

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

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

Start organising the documents on the website. Move documents that are
concerned with Apertis policies (one way or another) into a "policies"
section and link to this from the main page.

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

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

Phabricator is a locked resource, only accessible by Collabora and Bosch
employees at this point. Remove this from the community page as it's not
accessible by those most likely to be reading this page.

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

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

These bugs are not accessible by the general public, remove the link from
the Apertis documentation.

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

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

The system startup document is out of date. Provide a brief updated
description of the Apertis boot process and move to a new "architecture"
section. Split out the boot analysis into its own document and move to a
new "guides" section. Remove the previously performed optimisations as
these describe patched in changes that no longer appear to be a part
of Apertis.

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

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

This document describes functionality that was added to the Tracker
package. Apertis is no longer shipping a modified version of Tracker,
so this functionality is no longer available.

Remove this document to avoid confusion.

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

This allows to create branches in `origin` based on new distributions.
Help to avoid issues:
  $ git push origin origin/upstream/${UPSTREAM_BASE}:upstream/${UPSTREAM_DISTRIBUTION}
  error: unable to push to unqualified destination: upstream/bullseye

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

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

There are a number of broken links on the website that can be replaced with
updated links pointing to the relevant information. Where this is not
possible reword documents to not rely on the links rather than having
broken links.

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

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

This page appears to be a status page for the implementation of D-Bus
resiliance. The page provides links to numerous fixed bug reports and test
cases, but no information that remains relevant approx 6 years since it
was authored.

Removed the page in increase clarity of information on Apertis website.

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

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

The functionality described in this document seems to have been upstreamed
and is available in the upstream folks project.

Remove the link to the defunct Collabora repository.

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

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

This seems to now be on GNOME's GitLab, but also showed as archived.

Replace URL for now, might remove page later if it's found to be really out
of date.

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

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

This page was written prior to the Apertis project using gitlab. The
content it contains is either replicated in the the contribution
documentation or describes defunct processes that would be unavailable to
the average reader of the website (due to no access to Phabricator) even if
they were still true.

Remove this document to avoid confusion.

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

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

Google Code is no more. Update the link to a copy of the style guide else
where.

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

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

The phabricator workflow is not approriate for consumption by those not
inside Bosch or Collabora. The phabricator instance is password protected
and not accessible by the general public. Portions of this workflow also
do not make any sense outside a client relationship.

Move this content to the phabricator wiki where it is more relevant.

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

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

The references for the V4L APIs are no longer available, update the URLs to
point to available documentation.

The "mem2mem" reference for decoders was chosen after discussion with our
v4l experts.

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

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

The domain minnowboard.org is no longer active, remove the references to
content on this domain as it's unavailable.

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

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

The clutter/webkit-clutter documentation is very out of date, point to git
trees that are no longer available, bugs that have been resolved for 7
years and is no longer relevant to Apertis.

Remove this documentation to reduce confusion.

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

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

The Hugo Front Matter contains the title for each page, it is therefore
unnecessary to include a title as the first line in the markdown. Remove
the redundant titles to clean up page presentation.

Additionally we have a number of pages that have an initial title
"introduction", "intro" or similar. These are redundant so remove them too.

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

The "ICE systems" in the subtitle has been a source of confusion for
almost everyone.

The shorthand for In-Car Entertainment is not as common as the
In-Vehicle Infotainment (IVI) one, and too often people struggle to
remember what the acronym stands for.

It was a good placeholder in the design proposal, let's now find
something slightly more appropriate for the homepage.

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

The release schedule for the next releases lists dates as "TBC". Update
these pages with the correct dates.

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

The main page of the Apertis website was pointing at release schedules
of releases that had already been released and not pointing at the
currently released versions of Apertis. Whilst remedying this it became
apparent that we are storing the "current" versions in 3 different places
thus increasing the likelyhood that one will be missed on any update.

So:
- Merge the "release notes" and "release schedules" pages into a unified
  release page
- Point to this unified page and the current releases on the main page
- Update links as appropriate
- Add missing release schedules for next releases (with TBD dates for now)

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

The current search indexing only looks at "regular pages". This ensures
that a lot of the content is indexed and avoids the indexing of taxonomies
and other broadly irrelevant types of content in the index. However, it
does result in certain lists pages not being included in the index that
may contain valuable information.

The value of having the list pages indexed currently outweights the impact
of potentially including other tertiary data in the index, for a start
we're not currently using taxonomies. This should be re-evaluated as and
when we're able to spend time better structuring the website.

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

For users on slower connections/computers, the search index can take a
while to download and for the search to complete.

- Add a "Loading..." message to provide the user with some early feedback.
- Bump up the size of the text used when displaying status messages to
  make then clearer.

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

Fixed code formatting for commands examples.

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

Many of the document titles contain directory names and/or are missing
spacing between words. This has a number of effects:

- It gives users a bad impression of the quality of the information on the
  website
- It makes it harder for external search engines to catalog the contents
  of the website in a meaningful way
- Reduces the effectiveness of any local searching that we implement

Do an initial quick pass on the titles to make them more legible.

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

Emanuele Aina authored 4 years ago and Peter Senna Tschudin committed 4 years ago

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

The current search is using the URL "<site>/search", which is getting
redirected to the true location "<site>/search/". When running through
Hugo, the server it runs on localhost is maintaining the GET request
across the redirect, the hosting isn't.

The easiest (and arguably best) way or dealing with this is to correct the
URL so that no redirect is needed.

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

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

The statically generated site currently does not currently offer search
functionality. Whilst we could rely to a degree on search engines to index
the Apertis website (for example by using the provided integration of
Google Custom Search Engine) but it is expected that the website will be
used as the basis for more taylored sites by users of Apertis that may be
implemented out of the reach of the search engines indexing and thus
localised search is required.

Remove the Google search integration in the theme and instead integrate
local search based on the approach documented here:

https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae#layouts_defaultsearchhtml



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

This change adds secure boot on i.MX6 Sabrelite as a new feature of
Apertis v2021dev1.

Signed-off-by: Peter Senna Tschudin <peter.senna@collabora.com>

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

There was a missing `[`.

Signed-off-by: Peter Senna Tschudin <peter.senna@collabora.com>