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 5 years ago and Peter Senna Tschudin committed 5 years ago

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

Martyn Welch authored 5 years ago and Emanuele Aina committed 5 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>

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

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

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

Add the release schedule (a bit late) and the release notes for v2019.2.

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

The contribution process on designs.apertis.org currently has a section on
API review. This process doesn't fit with the focus of that document
(namely upstream contributions), so move it to the API documentation.

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

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

We have lots of duplicated and out-of-date information on various Apertis
sites. Remove the out-of-date information from the website for now and
point at the ci-package-builder documentation.

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

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

The docker image requires the path used during pull to be provided as part
of the image name else the following error is received:

Unable to find image 'apertis-v2021dev1-package-source-builder:latest' locally
docker: Error response from daemon: pull access denied for apertis-v2021dev1-package-source-builder, repository does not exist or may require 'docker login': denied: requested access to the resource is denied.
See 'docker run --help'.

Update the documentation to use the correct command.

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

The redirection from the old wiki redirects `wiki.apertis.org/*` to
`www.apertis.org/old-wiki/*`, currently this works when a specific page is
specified, but not when redirected to `www.apertis.org/old-wiki`.

Add in an extra alias to handle this case.

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

The wiki markup made it so that fragment links needed to be named as per
the link name, thus enforcing the link test for such URLs started with a
hash. As we are not using a wiki anymore, this is not the case and we can
clean out the hashes to make the text more readable.

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

There are a number of badly formatted links that don't point correctly to
resources or point to resources that aren't available. Where possible
correct the links, if this is not possible remove or neuter the link to
preserve as much as possible.

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

The theme doesn't provide a mechanism to have links in the footer. Add one
and include the links to important information that we had on the wiki.

As the code of conduct is now in the footer. Add a download link in the
header.

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

A number of files in the `content/` directory are either unlinked (and
therefore hidden) or would have contained a message (generated by a wiki
template) stating they were obsolete and pointing to the updated location.

 - Move the unlinked documents into guidelines so that they are at least
   accessible via the automatic list, link if a quick location can be
   found.
 - Remove the obsolete pages and update the links to point to the correct
   location.

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

The only document to which this page points is no longer provided. Remove
the page.

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

Remove link it a page that changed name and remove wiki specific help page.

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

The definitions used to be pulled into the privacy policy by a macro. Move
them there now we aren't using a wiki.

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

A number of documents used to be marked as work in progress on the wiki.
Move these to their own folder to make this distinction.

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

This content is a duplicate of:

https://designs.apertis.org/latest/hardkeys.html



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

This is essentially an out-of-date version of the information in
`virtualbox.md`, remove it.

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

Verified boot has been documented here:

https://designs.apertis.org/latest/system-updates-and-rollback.html#verified-boot



Remove this page and link to the above information instead.

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

The 19.03 release was released under the new versioning convention as
`v2019dev0`, point to this release and remove hanging 19.03 release
schedule page.

Add 17.12.1 release to the list fo releases as it's not there.

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

The test suites are redundant. Remove them entirely.

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

The file `user_ofono-voicecall.md` is an out of place and obsolete test
case. Remove the file, putting an obsolete test marker in its place (but
in the correct location).

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

The discussion pages are a hangover from the wiki. The test cases arei
either obsolete or on qa.apertis.org now, the docs talk page is basically
review comments that we don't want on the website.

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

During conversion, when we hit a dangling reference to a page that didn't
exist, a placeholder was added for that page to allow Hugo to generate the
site. We now want to remove these pages.

 - Test cases: Replaced with "obsolete test" page.
 - Old bug links: Converted to broken link.
 - Link to specs removed.
 - Links to yet-to-be-created release notes removed.

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

We have further cases where we have both a `foo.md` an `foo/`. This results
in `food.md` being hidden. Move `foo.md` to `foo/_index.md` so that all
content is accessible, working on the assumption that the contents of
`foo/` are sub pages.

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

Move guidelines.md to be index for guilelines directory.

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

 - Move reference_hardware.md to be index so that it's rendered.
 - Add extra reference to hardware on main page.
 - Update links.
 - Correct links to pictures.

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

Rewrite links to the test cases for their actual location and remove links
to the now unusable templates. This allows the wiki category and templating
pages, which no longer function as expected as it's no longer a wiki.

The test case documentation is out-of-date, but rewriting this is out of
scope. See T6736.

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

The QA documentation is currently detached from the main page. Add a link
so that users can access it.

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

The weekly test report templates are no longer used as weekly testing is
now documented on https://lavaphabbridge.apertis.org/



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

The link to the pdf copy of the global search design document is broken
patch it up so it is downloadable from the link.

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

The test cases worked on the wiki by using mediawiki templating and
server side redirects. Since we no longer have this templating and a good
few more tests have been made obsolete since the redirects were setup,
lets replace them by using the previously setup redirect layout.

The tests were marked as obsolete if either the original templating marked
them as deprecated or the proposed URL returned 404 from qa.apertis.org.

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

A newer version of the didcot-service test case exists under
`content/qa/test_cases`. Remove this old duplication.

Add alias to the newer test case.

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

The release documentation currently live under `content/<version>/`, move
it into it's own section. This cleans up the content directory and may
enable us to do fancy things with Hugo templating further down the line.

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