Setup
Use the venv’s Python, not system Python -
.venv/bin/python -m pytest (or
.venv\Scripts\python.exe -m pytest on Windows). Bare pytest outside the
venv just reports missing deps.What good looks like
Small & focused
One concern per PR. Open a discussion before a large change so we can align.
Docs alongside code
When behaviour changes, update the CHANGELOG, the command/config reference,
and the relevant guide.
Tests pass
Lint (ruff) is blocking; the suite runs on Linux/macOS/Windows × Py 3.11-3.13.
Adding a language
Usually nothing to do - the embedder already knows it.