Building the PhotonVision Documentation

To build the PhotonVision documentation, you will require Git and Python 3.6 or greater.

Cloning the Documentation Repository

If you are planning on contributing, it is recommended to create a fork of the main docs repository. To clone this fork, run the following command in a terminal window:

git clone https://github.com/[your username]/photonvision-docs

Installing Python Dependencies

You must install a set of Python dependencies in order to build the documentation. To do so, you can run the following command in the root project directory:

python -m pip install -r requirements.txt

Building the Documentation

In order to build the documentation, you can run the following command in the root project directory:

make html

Note

You may have to run ./make html on Windows.

Opening the Documentation

The built documentation is located at build/html/index.html.

Docs Builds on Pull Requests

Pre-merge builds of docs can be found at: https://photonvision-docs--PRNUMBER.org.readthedocs.build/en/PRNUMBER/index.html. These docs are republished on every commit to a pull request made to PhotonVision/photonvision-docs. For example, PR 325 would have pre-merge documentation published to https://photonvision-docs--325.org.readthedocs.build/en/325/index.html