Editing User Guide
Info
If you are interested in editing the content (and not layout) of this user guide, simply edit the markdown directly in any markdown editor or on Github. There is a pencil icon linking to the markdown source on each page of these docs, which takes you directly to the source document.
Developing User Guide
When you want to edit the layout, organization and/or theme of these docs, you will need to run these project docs locally. This user guide is built with Python. You will need Python 3.x before proceeding.
-
If you are not a maintainer, fork the repo
-
Clone the forked repo and launch your favorite markdown editor and terminal.
-
Setup Python development env as follows:
-
Create virtual env for Python packages:
1
python3 -m venv env
-
Activate virtual env:
1 2
source env/bin/activate # macOS/Linux env\Scripts\activate.bat # Windows
-
Install requirements:
1
pip install -r requirements.txt
-
Run and debug the docs:
1
mkdocs serve
-
-
Relevant files:
- all written documents are under
guide
directory mkdocs.yml
at project root is a configuration file for Mkdocsguide/assets
includes static assets for these docsguide/overrides
includes customized template files that override default mkdocs-material templates
- all written documents are under
-
After editing the docs, commit your changes and open a PR as necessary. Travis CI is used to compile and publish the docs automatically after each merge to master branch.