- Sphinx docs come with a makefile build system. To preview, build PyPose locally and
sudo apt install build-essential
pip install -r requirements/dev.txt
cd docs
make html
-
Then open the generated HTML page:
docs/build/html/index.html
. -
To clean and rebuild the doc:
make clean
-
For the most simple case, you only need to edit the Python files and add docstring to functions following Google style.
-
Sometimes you may need to edit rst files like lietensor.rst, e.g., adding a new doc page. More details can be found at rst markdown.
-
Create a pull request.
Create a pull request. More details to be added.