Module page template¶
Every page under modules/ uses these sections, in order. Omit a section only if it genuinely does not apply.
- Purpose: one or two sentences on what the module is for and who uses it.
- Install: the package name and any extras.
- Wiring into a host app: the smallest working integration (settings, dependencies, router mounting).
- Configuration: settings keys and environment variables, in a table.
- Key concepts: models, actions, events and scopes the module introduces.
- Examples: two to four runnable snippets. Every snippet must be checked against the source or tests.
- Troubleshooting: common failures and fixes.
- Known issues: not a separate section. Where the code differs from the intended behaviour, put an inline notice next to the behaviour it affects, as described in Documenting known issues.
- API reference: link to the generated reference page. Do not hand-write signature tables.
- See also: related modules and guides.