3 ms·
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 doma
by rkagerer 7y ago
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?
- ericlippert 7y agoIn 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/ https://ericlippert.com/2014/09/08/comment-commentary/ for more thoughts on this subject.
- rkagerer 7y agoHey 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/CSharp/Portable/Binder/Semantics/Conversions/UserDefinedExplicitConversions.cs https://github.com/dotnet/roslyn/blob/master/src/Compilers/C...
- ericlippert 7y agoYeah, all the links are wrong now. I'll fix them!
- 0x00000000 7y agoI 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.