20. /// comments that are not lies
Documentation comments, @arg on callables only, generated SDK docs, and CI verification.
/// comments that are not lies
Documentation lives next to declarations in /// line comments only—no XML novel, no separate doc assembly that drifts from the code every sprint. If the comment disagrees with the compiler, the compiler wins.
What you will find here
Section titled “What you will find here”| Section | Topic |
|---|---|
| Doc comment syntax | Doc runs and attachment rules. |
| @arg and cross-links | Callable params only; @ref validation. |
| Generated SDK docs | Mirrored compiler SDK sources. |
| Verify docs | trudoc and CI presets. |