[geeks] SA Documentation creation/mgmt

[velociraptor]

On Mon, 25 Oct 2004 21:39:26 -0400, Phil Stracchino
<alaric at caerllewys.net> wrote:
> On Mon, Oct 25, 2004 at 08:52:03PM -0400, velociraptor 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.
> >
> > I looked at a couple of Weblog/Wikipedia crosses, but the danged
> > taxonomy business just seemed way too overloaded for 30-some servers.
> >
> > Am I nuts for thinking there's something out there like this, or off
> > my rocker for thinking I'll ever get admins to document stuff?
> 
> In Cygnus releng, we had a shared document in CVS that people were
> expected to check out and update any time they made changes to anything.

I am hoping to get the others to start using RCS for conf files (prays
to ghods, sacrifices something on admin box) and pushing them from the
central server.  I think we have too much complexity to put everything
in a flat file.  2 versions of 2 apps, +4 other apps and all the
administrative foo to support them all.

Right now everyone creates text or docs and sends them to the others in email.

> These days, I don't know that I can think of a tool a lot better than a
> wiki, but I don't know a lot about wikis.

I think a little more structure is in order, that's why I was leaning
towards wiki/blog cross.

> Unless, of course, you can appoint somebody Documentation Czar with
> responsibility for maintaining the document in HTML.

I wish.  There's not enough bandwidth to go around as it is.

Looks like I need to dig more into the wiki/blog space.

=Nadine=