Feng ad6b82ed28 Update contribute to doc link (#251) 2 lat temu
..
_static f2a30bd1b2 Documentations (#242) 2 lat temu
_templates f2a30bd1b2 Documentations (#242) 2 lat temu
api f2a30bd1b2 Documentations (#242) 2 lat temu
content f2a30bd1b2 Documentations (#242) 2 lat temu
environments aadf537175 CNAME and dependencies for Documentations (#245) 2 lat temu
scripts aadf537175 CNAME and dependencies for Documentations (#245) 2 lat temu
.gitignore f2a30bd1b2 Documentations (#242) 2 lat temu
404.md f2a30bd1b2 Documentations (#242) 2 lat temu
LICENSE f2a30bd1b2 Documentations (#242) 2 lat temu
Makefile f2a30bd1b2 Documentations (#242) 2 lat temu
README.md f2a30bd1b2 Documentations (#242) 2 lat temu
conf.py ad6b82ed28 Update contribute to doc link (#251) 2 lat temu
index.md ad6b82ed28 Update contribute to doc link (#251) 2 lat temu
make.bat f2a30bd1b2 Documentations (#242) 2 lat temu
requirements.txt f2a30bd1b2 Documentations (#242) 2 lat temu

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