Manuel Goulão 270fccfd66 Update docs to Farama sphinx theme (#254) 2 years ago
..
_static 270fccfd66 Update docs to Farama sphinx theme (#254) 2 years ago
_templates f2a30bd1b2 Documentations (#242) 2 years ago
api f2a30bd1b2 Documentations (#242) 2 years ago
content f2a30bd1b2 Documentations (#242) 2 years ago
environments aadf537175 CNAME and dependencies for Documentations (#245) 2 years ago
scripts aadf537175 CNAME and dependencies for Documentations (#245) 2 years ago
.gitignore f2a30bd1b2 Documentations (#242) 2 years ago
404.md f2a30bd1b2 Documentations (#242) 2 years ago
LICENSE f2a30bd1b2 Documentations (#242) 2 years ago
Makefile f2a30bd1b2 Documentations (#242) 2 years ago
README.md f2a30bd1b2 Documentations (#242) 2 years ago
conf.py 270fccfd66 Update docs to Farama sphinx theme (#254) 2 years ago
index.md ad6b82ed28 Update contribute to doc link (#251) 2 years ago
make.bat f2a30bd1b2 Documentations (#242) 2 years ago
requirements.txt 270fccfd66 Update docs to Farama sphinx theme (#254) 2 years ago

README.md

MiniGrid-docs

This repo contains the [NEW website]() for MiniGrid. This site is currently in Beta and we are in the process of adding/editing information.

The documentation uses Sphinx. However, the documentation is written in regular md, NOT rst.

If you are modifying a non-environment page or an atari environment page, please PR this repo. Otherwise, follow the steps below:

Instructions for modifying environment pages

Editing an environment page

If you are editing an Atari environment, directly edit the md file in this repository.

Otherwise, fork Gym and edit the docstring in the environment's Python file. Then, pip install your Gym fork and run docs/scripts/gen_mds.py in this repo. This will automatically generate a md documentation file for the environment.

Build the Documentation

Install the required packages and Gym (or your fork):

pip install -r requirements.txt
pip install gym

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 ./source build/html