Why this matters
`///` comments allow tools like dartdoc to generate documentation, improving maintainability and usability.
Use `///` instead of regular comments to properly document Dart classes, methods, and properties for automatic documentation generation.
`///` comments allow tools like dartdoc to generate documentation, improving maintainability and usability.
Side-by-side examples engineers can pattern-match during review.
// The number of characters in this chunk when unsplit.
int get length => ...int get length => ...// The number of characters in this chunk when unsplit.
int get length => ...int get length => ...From the same buckets as this rule.
For changes that affect architecture, data models, external APIs, security posture, deployment topology, or cost (>10%), create an ADR in docs/adr/ using the standard template (Context, Decision, Consequences) and link the PR and issue IDs.