One new possibility is wiki.
I suggest people decide on a man style format.
Even if it is not compleltely standard from the start
it will evolve. Finally, all documentation be put on
a wiki with version control. Anybody can modify
or annotate the docs and after some time
a people wishing to earn a reputation as
a writer can review the history of documentation
changes and evolve the documentaton
to the next level.
I would encourage not using a Wiki - for these reasons:
- Requires yet another password, login, signup, address, name, …
- Can’t be downloaded and set up like HTML pages (like the ruby-man and ruby-ref, which are wonderful!)
- Can’t be printed out for hard copy
- Can’t be used offline
However, rdoc and rtool can both be used offline and can create documentation suitable for offline use; same goes for man pages.
For general documentation, why not use DocTool?
CUNA & Affiliates
UNIX Systems Administrator