in reply to Re: Code Maintainability
in thread Code Maintainability
As for who I do and don't want to work with, I have had the displeasure of working with people who never comment, and of working with people who comment everything heavily. Of the two styles I far prefer no comments at all. The style that I personally like is very sparsely commented code that is written in such a way that the code itself stands as a comment.
For more details I strongly recommend reading the old thread starting at Re (tilly) 2 (disagree): Another commenting question,. In that thread I discuss in detail a piece of code that I just wrote, the commenting decisions that I made, and the reasons for my deciding what to comment, where and when. I no longer hold to quite that style, these days I'm inclined to write longer variable names than I was back then, but I haven't changed views by that much.
|
---|
Replies are listed 'Best First'. | |
---|---|
Re^3: Code Maintainability
by doom (Deacon) on Dec 07, 2008 at 00:02 UTC | |
by tilly (Archbishop) on Dec 08, 2008 at 03:01 UTC |