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 is going to get switched off. Replace the link in the header with
one to the community information.

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>

There are a number of rules setup to redirect to qa.images.org for test
cases. We can do this with a custom layout and slightly abusing the "title"
variable in the front matter to give us the name of the test.

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>

The test reports currently live under `content/<version>/testreports/`. In
order to take advantage of Hugo's list pages move the test reports to
`content/qa/weekly_tests/<version>/`.

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

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

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

We have a QA page and directory. In order to get things working better
move qa.md to qa/_index.md so that it's used.

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

A wayward feature/bug in Hugo 0.63.1 results in the homepage being badly
formatted:

  https://github.com/gohugoio/hugo/issues/6805



This is rectified in 0.63.2, but the docker image for this does not exist
yet.

It seems that it is risky for us to depend on `latest` in the CI runner
as this can result in unpredictable issues with the website. As the
`stable` Hugo branch tracks the latest release, it wouldn't have helped us
in this instance (the issue was present in the latest release) and this
doesn't seemed to be tracked by the docker image registry.

Lock to version 0.62.2, we will have to update this more manually on a
regular basis.

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>

The conversion to markdown broke the <code> snippets.

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

Update the image used to depict the SDK running in a VM.

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