Email: Password: Remember Me | Create Account (Free)

Back to Subject List

Old thread has been locked -- no new posts accepted in this thread
???
11/02/04 13:14
Read: times


 
#80258 - RE: Commenting
Responding to: ???'s previous message
And now that the code is working "terrific", whatever motivation was there to comment it, would have vanished!!

Do not worry, when "that little glitch" or "that added customer request" show up you will spend hours upon hours commenting it in order to understand what you, yourself, wrote.
In the development phase there is very little need for commenting because all is fresh in your mind, but you will have to come back to the code some day (if you are still employed) and the the defecation hit the rotary oscillator.

The sad thing is that when you can easily comment (while developing) the need is the least, when you need the comments (enchancing or fixing) the ability is the least.

It is a common misconception that you are to comment for other peoples benefit, try understanding a piece of uncommented code when you are asked to modify it a year or two later yourself.

Erik

PS whoever said that "C" was self-documenting should be executed at dawn.


List of 27 messages in thread
TopicAuthorDate
Elevators logic            01/01/70 00:00      
   RE: Elevators logic            01/01/70 00:00      
   RE: Elevators logic            01/01/70 00:00      
      RE: Elevators logic            01/01/70 00:00      
         But            01/01/70 00:00      
         RE: Elevators logic            01/01/70 00:00      
      RE: Elevators logic            01/01/70 00:00      
   RE: Elevators logic            01/01/70 00:00      
      RE: Elevators logic - Bartosz            01/01/70 00:00      
      VINDICATION!            01/01/70 00:00      
         Repeated pushes...Joseph            01/01/70 00:00      
            RE: Repeated pushes...Joseph            01/01/70 00:00      
               RE: Repeated pushes...Joseph            01/01/70 00:00      
                  RE: Repeated pushes...Joseph            01/01/70 00:00      
   Elevators and women            01/01/70 00:00      
      RE: Elevators and women            01/01/70 00:00      
      Up or Down - thats the question!            01/01/70 00:00      
         RE: Up or Down - thats the question!            01/01/70 00:00      
            Commenting            01/01/70 00:00      
               RE: Commenting            01/01/70 00:00      
               RE: Commenting            01/01/70 00:00      
                  Good advice - Erik            01/01/70 00:00      
                  RE: Commenting            01/01/70 00:00      
                  RE: Commenting            01/01/70 00:00      
                     RE: Commenting            01/01/70 00:00      
   RE: Elevators logic            01/01/70 00:00      
   RE: Elevators logic            01/01/70 00:00      

Back to Subject List