Hacker News new | past | comments | ask | show | jobs | submit login

Shockingly,

    InStr(<this page of 100+ comments>, "docum") = 0
I'm a dev with some grey hair who feels it would have been useful for all that fantastic domain knowledge from Paterson to get documented in a code comment.

I'd love to hear if either of them ever went back and did that?




In this case I think not. However I strongly agree with your position and have tried hard to ensure that my code is commented such that it explains why the code works as it does. See https://ericlippert.com/2014/09/08/comment-commentary/ for more thoughts on this subject.


Hey Eric thanks for responding here!

Love that article, it was interesting to read your dissection of code comments.

For anyone else reading it, here's an updated link to the CS file referenced in his blog post (the original moved): https://github.com/dotnet/roslyn/blob/master/src/Compilers/C...


Yeah, all the links are wrong now. I'll fix them!


I was looking for this, thank you. I cannot get over when people try and keep all this knowledge in their head. Have they never worked on something written by someone other than themselves? I know it usually isn’t, but it really feels like some kind of hubris that makes people allergic to writing a paragraph block comment in the code.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: