Building the documentation

So meta. First of, activate your virtualenv and install dedicated dependencies:

$ pip install -r requirements/doc.pip

Then you should be able to build and serve the documentation using the dedicated invoke task:

$ inv doc

Open http://127.0.0.1:8000/ and enjoy the live reload of your changes. Docs are located within the udata/docs/* directory and use the markdown format.

Behind the scene, it uses MkDocs so feel free to use directly for advanced usage:

$ mkdocs --help