[thelist] Documentation best practices?

[Johnson, Christopher (MTO)]

First question that must be asked is what language are you dealing with?
Some languages come with Documentation features and practices built in,
i.e., java has javadoc. for C, C++ you can use DOxygen (similar to javadoc).

One suggestion that seems to work for some is to use a wiki for the
documentation. This way, anyone who works on the project is able to quickly
and easily update the documentation.

chris

-----Original Message-----
From: Joel Konkle-Parker

The application in question is multiplatform, and so must be the
documentation.
I'm somewhat attracted to the HTML idea, but I'm not sure if this is the
best
way to go. PDF is also an option. I've also heard of meta-languages that let
you mark up and expand to different formats from there, but I have no
experience with such things.