jbpoline / documentation

The neurobagel documentation

documentation

The neurobagel documentation.

Our docs are built with the Material Theme for MKdocs.

Setup

Create a new virtual environment with python -m venv venv and activate it. Then install the dependencies with pip install -r requirements.txt

Build

To spin up the side locally while you edit it, run:

mkdocs serve

More details are in the mkdocs documentation.

Deploy

At the moment we are using mkdocs to deploy directly to gh-pages.

When your local build runs well, commit the changes to the main branch with a PR and then call

mkdocs gh-deploy

See the docs for more details.