This documentation is built with MkDocs, themed with Material for MkDocs and is hosted on GitHub Pages.
Generated documentation is available at: https://docs.updatehub.io
Create a virtual environment (venv directory):
virtualenv venv
Install the required packages to build documentation:
./venv/bin/pip install -r requirements.txt
mkdocs.yml - it is the configuration file: navigation structure, theme definitions,personal informations, among others are here.If you add or remove pages, change this file according according changes.
docs - this folder contains the pages contents of the documentation.
To edit the documentation, just edit the files inside src.
In order for content to show up, it needs to be added to the configuration,
i.e., in the nav section of the mkdocs.yml file.
Some pointers:
You can test what the documentation looks like, using the following command and opening a browser on localhost:8000:
./venv/bin/mkdocs serve
mkdocs monitors setup and markdown files, so you can just add and edit them as you like, it will automatically rebuild and refresh the browser.