This folder contains the documentation for PettingZoo.
For more information about how to contribute to the documentation go to our CONTRIBUTING.md
Environments' documentation can be found at the top of the file python file where the environment is declared, for example, the documentation for the chess environment can be at /pettingzoo/classic/chess/chess.py
To generate the environments pages you need to execute the docs/_scripts/gen_envs_mds.py script:
cd docs
python _scripts/gen_envs_mds.py
Install the required packages and PettingZoo:
pip install -e .
pip install -r docs/requirements.txt
To build the documentation once:
cd docs
make dirhtml
To rebuild the documentation automatically every time a change is made:
cd docs
sphinx-autobuild -b dirhtml . _build
The plugin pytest-markdown-docs allows us to test our documentation to ensure that example code runs successfully. To test, run the following command: pytest docs --markdown-docs -m markdown-docs