llm/docs/contributing.md
Simon Willison b9865a5576 Multi-page docs using Markdown and Sphinx, refs #21
Also documents new keys.json mechanism, closes #13
2023-06-15 17:51:12 +01:00

879 B

Contributing

To contribute to this tool, first checkout the code. Then create a new virtual environment:

cd llm
python -m venv venv
source venv/bin/activate

Or if you are using pipenv:

pipenv shell

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

pytest

Documentation

Documentation for this project uses MyST - it is written in Markdown and rendered using Sphinx.

To build the documentation locally, run the following:

cd docs
pip install -r requirements.txt
make livehtml

This will start a live preview server, using sphinx-autobuild.

The CLI --help examples in the documentation are managed using Cog. Update those files like this:

cog -r docs/*.md