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

Back to Subject List

Old thread has been locked -- no new posts accepted in this thread
???
01/20/04 15:32
Read: times


 
#62984 - RE: Good Documentation
Responding to: ???'s previous message
What do you mean by "outside the code" Erik ? Before I get on my high horse.
If you do, please do not ride into the sunset.

Anyhow, "outside the code" means outside the file(s) where the code reside.

I have seen, I don't know how many, "documentations" in separate binders where "the slight difference due to code updates forgotten in the documentation" led to some poor sod running around in circles for days because of relying on understandable documentation instead of non-understandable code.

Another reason for the argument is that, if outside documentation exist, you have the perfect excuse for not commenting your code to a reasonable level.

Erik





List of 29 messages in thread
TopicAuthorDate
Good Documentation            01/01/70 00:00      
   RE: Good Documentation            01/01/70 00:00      
      RE: Good Documentation            01/01/70 00:00      
         RE: Good Documentation            01/01/70 00:00      
         RE: Good Documentation            01/01/70 00:00      
            RE: Good Documentation            01/01/70 00:00      
               RE: Good Documentation            01/01/70 00:00      
               RE: Good Documentation            01/01/70 00:00      
   RE: Good Documentation            01/01/70 00:00      
   RE: Good Documentation, Andy, Pravin            01/01/70 00:00      
      RE: Good Documentation, Andy, Pravin            01/01/70 00:00      
         RE: Good Documentation - clarification            01/01/70 00:00      
            RE: Good Documentation - clarification            01/01/70 00:00      
               RE: Good Documentation - clarification            01/01/70 00:00      
                  RE: Good Documentation - clarification            01/01/70 00:00      
                     RE: Good Documentation - clarification            01/01/70 00:00      
                        RE: Good Documentation - clarification            01/01/70 00:00      
                           RE: Good Documentation - clarification            01/01/70 00:00      
                              RE: Good Documentation - clarification            01/01/70 00:00      
                                 RE: Good Documentation - clarification            01/01/70 00:00      
                                 RE: Good Documentation - clarification            01/01/70 00:00      
                                    RE: Good Documentation - clarification            01/01/70 00:00      
                              RE: Abdul            01/01/70 00:00      
            RE: Good Documentation - Pravin            01/01/70 00:00      
   RE: Good Documentation            01/01/70 00:00      
      RE: Doctors and documentation            01/01/70 00:00      
         RE: raghu            01/01/70 00:00      
            RE: raghu            01/01/70 00:00      
            RE: raghu            01/01/70 00:00      

Back to Subject List