Re: [SAGE] Unix sys admin "run book" documentation standards andtemplates

[Jim Hickstein <jxh@jxh.com>]

> My department, which has nearly 20 Unix sys admins running about as many
> distinct administrative domains*, needs to put together some sort of "run
> book" documentation so that any admin can come quickly up to speed in any
> other admin's domain.

We use TWiki (www.twiki.org) to contain documents written to a template I 
wrote a long time ago: 
"http://www.jxh.com/jxhc/ops-if/characteristics.html".

Someone once said you should write things so a trained monkey can follow 
along and fix things.  This is important because, after six months, you 
_are_ a trained monkey even at your own site.