Articles hosted on docs.ubuntu.com don’t link reliably to the rest of the project’s site

[matthewpaulthomas]

A1. Arrive at the Maas release notes from a search engine or other site.
A2. Try to find the download page.

B1. Arrive at the Ubuntu Core security page from a search engine or other site.
B2. Try to find the download page.

What happens: You can’t get there from here.
What should happen: It’s part of the standard navigation, just like it is on every other part of the project’s site.

One way of fixing this would be integrating the docs as part of their respective project sites. (This would also solve other problems, such as missing/ineffective search.)

Next best would be to let each project embed its own navigation, in toto, onto its section of docs.ubuntu.com. This is apparently the approach taken by docs.docker.com, docs.travis-ci.com, and kubernetes.io/docs: on each, the navigation is nearly consistent with the rest of the site (probably drifting out of sync as one or the other site is tweaked).

The simplest, but least consistent, solution would be to provide a way for each project to link from its docs to its front page, and place that link first in the docs.ubuntu.com header.