Skip to content

Contributing

See CONTRIBUTING.md in the repository for the development setup, the three mechanical gates (operating-point drift, spec coverage, layering), and how rulings are superseded. An existing ruling is never edited.

Docs-specific notes:

  • The site builds with mkdocs-material: pip install -e ".[docs]" -c constraints/docs.txt && mkdocs serve.
  • docs/spec/rulings.md is generated by tools/render_rulings.py. Edit the ruling TOML under src/punchmark/spec/rulings/. Do not edit the rendered output by hand.