Contributing

Documentation lives in the same repository as the code and follows the same review process.

Making a change

Edit the Markdown file, open a pull request, request a review. Every page carries an edit link that takes you straight to the right file.

What belongs here

Decisions, contracts, and reference material that outlives a sprint. If a note stops being true after one release, it belongs in the pull request description instead.

Style

Short sentences. Present tense. No marketing language. A table beats a paragraph whenever the content is comparable.