Rules Hub
Coding Rules Library
← Back to all rules
Rule priority, scope & exceptions
Use this to align rules with the senior-level structure (P0/P1/P2, scope, exceptions/tradeoffs).
backend ruleP2stack specificStack: node
swaggerdocumentationdry
Reuse a single description string for code and ApiOperation docs
When the same human description applies, feed it into ApiOperation so Swagger docs stay in sync with the code's intent.
PR: vinify-backend · org-mining-deep-2026-06Created: Jun 17, 2026
Bad example
Old codetypescript
| 1 | // description in a code comment only; Swagger has none |
Explanation (EN)
Objašnjenje (HR)
Good example
New codetypescript
| 1 | @ApiOperation({ description: ENDPOINT_DESCRIPTION }) |
Explanation (EN)
Objašnjenje (HR)