@petealexharris @raineer @drahardja @skyfire747 @nomenloony @blogdiva Don't you do that anyway when you add comments to your code?
@technicaladept @raineer @drahardja @skyfire747 @nomenloony @blogdiva
No, a duplicate explanation of what the code is doing is not what comments are for.
Comments are more for "why" one method or choice than another, sometimes "why not", than "what".
Except doc comments, which are closer to spec i.e. "what". The code itself is "how", and it doesn't necessarily come via a verbal description in natural language.
@petealexharris @technicaladept @raineer @drahardja @skyfire747 @nomenloony @blogdiva just like you don't explain to the client why you use a nail and not a screw when building a chair. You explain how to use the chair and if there's something that works different to a normal chair.
Edited 17d ago