Simon Willison’s Weblog

simonw/docs cookiecutter template. Over the last few years I’ve settled on the combination of Sphinx, the Furo theme and the myst-parser extension (enabling Markdown in place of reStructuredText) as my documentation toolkit of choice, maintained in GitHub and hosted using ReadTheDocs.

My LLM and shot-scraper projects are two examples of that stack in action.

Today I wanted to spin up a new documentation site so I finally took the time to construct a cookiecutter template for my preferred configuration. You can use it like this:

pipx install cookiecutter cookiecutter gh:simonw/docs 

Or with uv:

uv tool run cookiecutter gh:simonw/docs 

Answer a few questions:

[1/3] project (): shot-scraper [2/3] author (): Simon Willison [3/3] docs_directory (docs): 

And it creates a docs/ directory ready for you to start editing docs:

cd docs pip install -r requirements.txt make livehtml