logo

New Response

« Return to the blog entry

You are replying to:

    • avatar
    • axel
    • Posted on Thu 28 Mar 2013 04:57 AM

    Hi Fabian,

    I even comment on atnotes and have visited uklug last year. I haven't opened a Notes Client for 2 years and my last line of code should date 3 or 4 years back.

    Nostalgia. Don't know. Probably the awsome work environment back than at Kasten ;-)

    And yes, there are lots of pointless comments, at least on the projects I participate. Architects and Project Managers love to activate checkstyle rules for comments and programmers love to find ways to trick this rule with the least amount of effort.

    Writing good comments is hard. I am only theoretically good at that. Just at this very moment I don't understand part of some strange stuff in some jsf beans, I have written 2 month ago.

    We need comments in the not obvious parts of the program. I tend to write these late in the day in an empty office. In the process I change a lot, so I don't see much point to write comments as there is a high probability that I will delete this source code. I should write comments when this for me hard part stabilizes, but I often tend to "forget".

    Thou shall write comments is an ok guideline, but what we really need are good comments and this is hard.

Your Comments

Name:
E-mail:
(optional)
Website:
(optional)
Comment: