[geeks] SA Documentation creation/mgmt

[Bryan Fullerton]

On Mon, 25 Oct 2004 23:57:20 -0400, velociraptor <velociraptor at gmail.com> wrote:
> On Mon, 25 Oct 2004 22:22:06 -0400, Bryan Fullerton <fehwalker at gmail.com> wrote:
> > - a wiki for free form documentation, we use MoinMoin
> > (http://moinmoin.wikiwikiweb.de/)
> 
> I looked at this when I was reviewing wiki/blog crosses, but didn't
> want to have to go down the full-blown Apache/MySQL/PHP route. 

By 'looked at this' were you referring to MoinMoin? It's just a bunch
of Python scripts running as CGIs - doesn't even require any
additional Python modules, just the base interpreter. And there's a
FreeBSD port. (www/moinmoin :)

> Hmm...I will investigate Maven. 

It's really aimed at Java documentation, but if you need that for
other stuff it can be a useful way to get your docs up in a tidy and
consistent way. And who knows, it might get your Java developers to
start documenting...

> I lean towards rcs; haven't used cvs,
> really.  Suggestions for a crash intro?

CVS is (very) basically a network wrapper around RCS - if you look in
a CVS repository you'll see the familiar foo,v files you'd see in a
RCS directory.

My preferred way to figure stuff out is to use it, so I started by
basic checkout of various CVS builds of open source projects, and when
I wanted to play with a CVS repository I set one up for storing config
files for my servers.

> Fortunately, I don't have to do anything other than verbally abuse the
> developers and then deploy their crappy code.  :-/  Of course, the
> developers don't work for us--they are employed by the government
> agencies that share our hosting environment.

I don't even have to deploy code, my group just supports the
servers/network. Yay!

Bryan