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

# Documentation Guidelines

## Code Samples

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

## Diagrams

Use Mermaid for architecture and flow diagrams. Keep diagrams close to the code they describe.

## Style

- Task-oriented headings (nouns)
- Active voice, second-person
- Keep paragraphs under three sentences
