----- "Hugh Brown" <[email protected]> wrote:
> You might want to have a look at Confluence
> (http://www.atlassian.com/software/confluence/).  We use it at $WORK
> and so far I've found the ACLs easy enough to work with...though for
> the most part, our wiki is more open than closed.  The latest version
> supports working with Word, but I haven't tested that at all and I
> can't remember if it will import or not.  (Must...finish...coffee...)
> 
> Thanks,
> Hugh

we have found that Mindtouch is excellent at ACLs, and we even have customers 
able to login and see only their pages (for the documentation we keep for 
them). Mindtouch used to be called dekiwiki:

http://www.mindtouch.com/

It does have a Commercial and Open Source version, and the Desktop Tools, 
allowing you to save a Word doc into the wiki with one click are available for 
purchase stand-alone now.

The Open Source version does most of what we need, and has an amazing API.

Speaking of which....

We use the the mindtouch API to automatically document machines via a bash 
script with curl. The script dumps out an HTML page of the system specs, and 
posts it to the wiki using perl.
Using the API, we can even keep the page up to date automatically using a cron 
job, as the script can just update the page (as opposed to creating a new one).
I am a firm believer in using templates and scripts to try and automate the 
creation of documentation as much as possible. My next task will be to create a 
script that can live on a linux box on a customer network, and discover as much 
as possible about that network, and then update the documentation for me :) 
Should all be possible as an extension of the host documentation script we have.

Here is an sanitised version of the script:

#!/bin/bash
./audit_ubuntu.sh
authtok=`curl -s 
http://username:[email protected]/@api/deki/users/authenticate`
hostname=`hostname`
echo ""

curl -X POST -d @$hostname-audit.html  
"http://username:[email protected]/@api/deki/pages/=Incoming%252f$hostname/contents?authtok=$authtok";
echo ""

We then move the page from incoming to the customer information page for that 
customer, and any further updates automatically update the page, as it will be 
called the `hostname`.

audit_ubuntu.sh is a script that comes from one of the network auditing tools, 
I can't remember which.

As you can see, it would be trivial to do all sorts of stuff, and keep the 
documentation up to date automatically.

Thanks,

Dave

_______________________________________________
Discuss mailing list
[email protected]
http://lopsa.org/cgi-bin/mailman/listinfo/discuss
This list provided by the League of Professional System Administrators
 http://lopsa.org/

Reply via email to