Contributing to Lagoon documentation#
We really value anything that you can offer us!
We've made building and viewing the documentation really straightforward, and the team is always ready to help out with reviews or pointers.
We use mkdocs with the excellent Material theme.
Viewing and updating docs locally#
From the root of the Lagoon repository (you'll need Docker), run:
docker run --rm -it -p 127.0.0.1:8000:8000 -v ${PWD}:/docs ghcr.io/amazeeio/mkdocs-material
This will start a development server on http://127.0.0.1:8000, configured to live-reload on any updates.
The customized Docker image contains all the necessary extensions.
Alternatively, to run the mkdocs
package locally, you'll need to install mkdocs, and then install all of the necessary plugins.
pip3 install -r docs/requirements.txt
mkdocs serve
Editing in the Cloud#
Each documentation page also has an "edit" pencil in the top right, that will take you to the correct page in the Git repository.
Feel free to contribute here, too - you can always use the built-in github.dev web-based editor. It's got basic Markdown previews, but none of the mkdocs loveliness.
How we deploy documentation#
We use the Deploy MkDocs GitHub Action to build all main branch pushes, and trigger a deployment of the gh-pages
branch.