Everyone in the Juju team is responsible for keeping its documentation up-to-date.
Workflow 1: Pull Request
This workflow has the advantage that you’re not responsible for checking for stylistic consistency.
To maintain consistency, please ask the documentation lead for a review before merging PRs.
|Clone the repository||
|Switch to the
|Create a feature branch||
|Edit the docs|
|Push to GH|
|Create a PR||
|Request a review|
You don’t necessarily need to work within your own fork of the project.
Workflow 2: Edit in place
Editing docs within Discourse will immediately update what is presented to users within our docs page.
If you want to do substantial edits this way, then create a duplicate of the current page and work on that. That will enable you to save work in progress without impacting what users see. Once you’re finished, copy and paste your new content into the original page. Then archive the topic that you used for your draft.
Discourse does not use valid Markdown. It also supports BBcode, for example. Your editor (probably) won’t have a syntax extension that supports it. C’est la vie.
Use the + New Topic button in the web UI to create a new page.
Images and videos are difficult to manage via the Discli/GitHub flow. You’re recommended to upload content via the Upload button within Discourse’s web UI then refer to that URL.