3 ms·
Comments should explain everything, but via links. Large comments cause context rot, so keep your comments tight and focused, and provide links to details as ne
by CuriouslyC 10mo ago
Comments should explain everything, but via links. Large comments cause context rot, so keep your comments tight and focused, and provide links to details as needed.
- chrisweekly 10mo agoAgreed... IFF you're linking to something immutable (Jira tickets probably qualify in many enterprise scenarios). Otherwise linkrot is at least as big a problem. Meaningful commit messages surfaced in-IDE via git blame can serve a similar purpose.