DragonFly docs List (threaded) for 2007-01
DragonFly BSD
DragonFly docs List (threaded) for 2007-01
[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]

Re: using a wiki for documentation (and introducing short-term beginning BSD admin book project)


From: "Justin C. Sherrill" <justin@xxxxxxxxxxxxxxxxxx>
Date: Fri, 5 Jan 2007 10:34:21 -0500 (EST)

On Fri, January 5, 2007 10:13 am, Jeremy C. Reed wrote:

> In hindsight, probably just doing the work in a wiki probably would have
> been best (other than the fact that original wiki, I think, was turned
> off). Because a wiki makes it easier and quicker for a larger community to
> contribute back. At least that is what I am hoping ...

To run with that thought...  I had suggested probably 2 years ago we use a
wiki instead of docbook, and while the idea was shot down then, I'm
thinking that wikis are common enough now that it's becoming just as
capable a tool.

The hassle of both understanding docbook/SGML and having the extensive
toolchain working on a DragonFly system has worked out so that there's
been almost no updates to the Handbook.  It's significantly more complex
to maintain than a wiki with no immediate benefit at this point, in my
opinion.

> A collaborative, short-term open source authoring project to quickly write
> a book covering the basics from the 2005 BSDA Certification Requirements
> Document was recently started. The BSD Certification Group's BSDA (BSD
> Associate) Certification is for BSD Unix system administrators with light
> to moderate skills.

Is this suitable for a Handbook replacement?

Is the wiki going to be maintained/reused past the publishing date of the
book?




[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]