This means that forum members will be able to edit/create documentation pages themselves, according to the trust level system built into Discourse. Because the web site will be updated automatically, the docs have effectively become a wiki.
The documentation now resides under the Docs category. There is a pinned topic that acts as the table of contents. The sub-category Docs-discuss is to be used for documentation-related subjects (stuff that is not intended to be published on the web site).
Documentation issues are still managed on the GitHub bug tracker.
Documentation editors are to use the Documentation guidelines. This will be important for maintaining the quality and the consistency of the documentation.
Previously there were distinct Juju versions you could select on the web site. Going forward, there will be a single documentation link, with its contents being exactly what resides in the ‘Docs’ category on this Discourse site.
There will therefore be the need for editors to “signpost” documented features in order for users to know what version provides what features. See Versioning in the guidelines page for details.
Legacy versions (2.5 and earlier) will be archived for viewing on a separate domain.
Large community-contributed pieces
We may have a place within the table of contents (navigation menu) to link to large community-contributed pieces of text. These pages may also be labelled as such. An example of this are tutorials. There is a concern that such contributions may include a writing style and organisation that differs significantly enough from the existing body of documentation to result in a poor user experience on the web site. It is hoped that such pieces will eventually be kneaded into the rest of the documentation. Ideally, then, editors should strive to base their writing on the style of the existing documentation and make full use of the aforementioned documentation guidelines.
Documentation file import
The documentation has already been imported several times into Discourse and has undergone a QA process. There is still one lingering issue (lack of Markdown support within admonishments) but this is not a blocker. Admonishments also currently suffer from a colour problem.
Web site publishing
The automatic publishing of changes made in Discourse won’t be ready immediately. This will occur by mid-April 2019. Consequently, there will be a window of a few weeks where documentation updates will only be visible within Discourse.