News for hackers. Stuff that matters.
Re:Thoughts on being a programmer by creativename on Tuesday August 14, 2012 @01:34PM (#4382062)
Yeah, that's exactly the kind of formality and over-commenting that I meant by "I feel like there are some people who go overboard on the formalities of commenting (specific format, etc.)". I saw a lot of examples of that at my old employer where they had tried (and failed) to automate some of their documentation years and years ago.

It's nice to have a brief description of what a class (or in many cases, a method) is intended for, etc. As others have said, it saves time each successive programmer from having to fully understand all of the source code.

Re:Thoughts on being a programmer by lawn on Tuesday August 14, 2012 @01:49PM (#4382151)
Ah I see, misunderstood a bit.