On Tue, Mar 02, 2010 at 11:07:18AM -0800, Aleksey Tsalolikhin wrote:
>   Do you have an infrastructure for documentation that makes it easy
> and pleasurable to add or update documents?  If not, you need to
> develop one.  Personally, I like the power of DocBook XML, and the
> convenience of an AsciiDoc front end to cut down on the tag soup.

Easy, sure.  Pleasurable?  That might be motivation to construct a
system that dispenses a number of jellybeans upon successful completion
of ever wiki page.....

But seriously, yes, we've got a wiki in place.  I've used DocBook
before, and I liked it, but honestly, it's hard enough to get people to
use the wiki, let alone the simple wiki markup.  Throw XML into the mix
and buy-in from the team goes way down, unfortunately.  AsciiDoc might
be worth looking into though.

-jkl
_______________________________________________
Discuss mailing list
Discuss@lopsa.org
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