---
applyTo: "docs/**/*.md, docs/*.md"
---

# Documentation Guidelines

## Code Samples

- Every code block must be runnable and validated
- Use Sphinx cross-references: `:class:`CharacteristicData``, `:meth:`parse_characteristic``
- Pair code with expected output

## Style

- Google-style docstrings (see python-implementation.instructions.md)
- Task-oriented headings (nouns)
- One-sentence summaries
- Active voice, second-person
- Keep paragraphs under three sentences
