How to Edit This Site

Documentation for our site is written using markdown and published through Github pages using mkdocs. If you're unfamiliar with using markdown, check out this handy cheat sheet.

In depth documentation for mkdocs can be found here.

Google Analytics for our site can also be viewed here

Install dependencies

In the terminal, install dependencies with:

pip install -r requirements.txt

Making changes

Our documentation is written in markdown and is organized into pages by mkdocs.yml. The main site is a combination of html and css.

For editing any pre-existing .md files, changes will be updated automatically
If you are adding any new files, then add the file under the mkdocs.yml's nav config like so:

nav:
   - Getting Started: "Getting Started.md"

This will make the file "Getting Started.md" visible on the web page's index

Previewing changes

To preview the documentation site before pushing changes to github:

In the terminal, run:

mkdocs serve

In any web browser navigate to 127.0.0.1:8000