4 ms·
I disagree. The code is the best place to comment the why. Regardless of what is documented or what is written up on jira or w/e, the code is what is true. Com
by minaa-chan 7y ago
I disagree. The code is the best place to comment the why. Regardless of what is documented or what is written up on jira or w/e, the code is what is true.
Commenting the purpose of the code and maybe a link to some documentation allows a future reader to see if the code still fulfills the requirements.
- CraigJPerry 7y agoThe comments are very often not true, that's why there's so much push back
- minaa-chan 7y agoSo they should be updated the same as any other documentation. They're there to help. They don't need to be 100% infallible to be useful.