How to write source code documentation?
Hi all!
I have a project where I have to write documentation for source code.
As I have no experience in writing documentation, I wanted to ask you guys- does any of you have any experience with that, and what recommendations could you give? Eventually links to good articles about that?
Thank you!
Iliya Yordanov,
www.csharp-home.com
Doxygen is possibly a good starting point.
Free the weed!! Class B to class C is not good enough!!
And the FAQ is here :- http://faq.cprogramming.com/cgi-bin/smartfaq.cgi
There are many different answers to your question.
Ask the person who gave you the "assignment" for more details... maybe you can get an example. Since apparently they didn't give you any specifics, I suspect they have no formal documentation standards. A few flow charts and some psudo code (or other text) may be adequate.
Some orginizations have very strict documentation formats and standards. You might assemble a very complete documentation package, but it won't be accepeted if it does not conform. At the small company where I work, it's very loose... whatever the programmer wants to do. (We are not a "software" company.)
