swift-docc
Installation
SKILL.md
Swift DocC Documentation
DocC compiles /// comments and .docc catalog files into a navigable hierarchy: landing
page → articles → symbol pages. A ## Topics group is what places a symbol in that hierarchy —
without it, DocC renders the symbol but nothing links to it from the navigation tree.
Step 1: Identify the scope
| What the user wants | Output to produce |
|---|---|
| Document one symbol | /// block in the source file |
| Organize many symbols under a type | /// block on the type with ## Topics |
| Add Topics without touching source | Extension .md file in the catalog |
| Module overview or conceptual guide | .docc catalog with a landing page article |
| Step-by-step walkthrough | .tutorial file — see tutorials.md |
Completion criterion: you know which output type(s) you will produce before writing anything.