3 ms·
Code doesn't explain best practices, architectural concerns, and so on. Best combo? Docs + code.
by theletterf 1mo ago
Code doesn't explain best practices, architectural concerns, and so on. Best combo? Docs + code.
- jaggederest 1mo agoIt also redirects the agents from adding enormous sloppy comments in the code - I have a linter that only allows 1 line comments with a reference to a docs folder tag `See BOB-IS-UNCLE.md` Then you can ruthlessly prune the docs folder on PR review and regular passes when e.g. claude really wants to write a novel about the glorious intricacies of bugs it's solved.