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

Jeremy C. Reed reed at reedmedia.net
Fri Jan 5 07:15:56 PST 2007


Over a year and half ago, I asked the DragonFly documentation workers to 
choose to just keep their handbook in progress in CVS. This was because 
there were two versions -- one in a wiki and one in DocBook in CVS -- that 
were growing independently (but were same originally). We didn't have 
tools (or time) to keep in sync and we didn't have tools (or time) to 
convert the wiki content into nice printable format.

Since then parts of the wiki disappeared and were lost and weren't 
committed back to the CVS. There has been random improvements to the CVS 
version. There have been patches submitted but I think never committed.

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 ...

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.

Using a wiki interface, authors, reviewers and readers all contribute to 
complete the book by the end of February. This bsdwiki contains over a 
hundred pages each with the topics defined by the BSD Certification Group.

A PDF in book format is periodically generated from this wiki content 
(which is converted to LaTeX).

To contribute, please join at http://bsdwiki.reedmedia.net/

The book is mostly generic BSD for beginning administrators, but there are 
a few topics that need some DragonFly-specific attention. If any of you 
can help, it would be appreciated.

Note that this is a short-term project, so no long term commitment is 
needed. And also any content in this new wiki is appropriately licensed 
and easily re-used by DragonFly.





More information about the Docs mailing list