Any Guidelines on Source Code Documenting? 
Author Message
 Any Guidelines on Source Code Documenting?

Hi Everyone,

I need help. I have finished my project. It is a CAD software for the
printed circuit board design and manufacturing industry. The program works
fine and is thoroughly tested; user's manual is written; everything is ready
to go. But I feel something is lacking--the source code is not documented.
Although I have been commenting on the source files while I coded, I have
not written anything comprehensive to document the software's data
structures, algorithms, limitations, assumptions, shortcuts, compilation
options, etc.... I think a standalone detailed document is needed for future
maintenance. I want to do it professionally so the next programmer will be
able to take over the project easily. I tried to find articles or books on
the standard/style/format for documenting source code but haven't found any.

Can you point me to the right direction? Do you have a book to recommend?
And what is your experiences or tips on documenting source code? How long it
takes to document a project of this size (approximately 45,000 lines of
code) thoroughly? What size should such documentation be?

Any input is greatly appreciated.

Tony Pan

P.S. I have posted this question on another newsgroup two months ago. Some
suggested me use UML developed by Rational Rose. I did some readings on UML
and found that it is quite complicated. It may be an overkill to what I want
to do with my project. I prefer something less sophisticated.

Wed, 25 Jun 2003 01:07:43 GMT  
 [ 1 post ] 

 Relevant Pages 

1. Source-Code Control / Document Control...

2. Need a program to document existing C source code

3. Tool to reformat and document source code

4. Self-documenting source code

5. where can I find document or source code about implementation of csocket using multithread

6. tools for documenting source code

7. how to convert source code pascal to source code c

8. Java source code to CSharp source code converter

9. Coding guidelines (was: Please, exchange experience on this

10. Coding Guidelines....

11. C coding guidelines

12. Guidelines for Good C code


Powered by phpBB® Forum Software