[geeks] SA Documentation creation/mgmt

[Bryan Fullerton]

On Mon, 25 Oct 2004 20:52:03 -0400, velociraptor <velociraptor at gmail.com> wrote:
> Ideally, I'd like an app that I could throw onto one of our central
> "admin" type servers so we could just fire up a web browser over the
> VPN and use that to mod/view the docs.

The consensus at $DAYBOB seems to be that the following places are
good for docs, depending what they are.

- a wiki for free form documentation, we use MoinMoin
(http://moinmoin.wikiwikiweb.de/)
- CVS directly for scripts and config files, with a web and/or Windows
front-end if required
- Maven (docs built from CVS) for more structured documentation that
managers see

The latter we use mainly because our developers are mainly coding in
Java, so it works for us to tie documentation for our projects in with
theirs.

Bryan