On Mon, Jul 28, 2008 at 12:08 PM, Michael DeHaan <mdehaan(a)redhat.com> wrote:
One of the things I've talked about previously is writing a much
involved "Best Practices" deployment guide for Cobbler. I think
Cobbler's far enough now that it would be a good time to do this, as the
core of things should not be changing so significantly that it will not
rapidly become out of date.
The focus would be on large scale and complex deployments, and would
roll up and incorporate all the content on the Wiki with various things
I hear from users about how they manage their deployments. This is
very much going to be a "book" in terms of length. How short or long
I'm not sure, but it will exceed the manpage and Wiki in scope.
I'm going to start working on that soon, so I am wondering if there is
anything specific you folks would like to see covered or included?
As with Cobbler, this is intended to be collaboratively developed, so
the document sources will be kept in git.
My main concern at this point is if the deployment guide would become
out of sync with the Wiki and/or manpage, so I'm tempted to just write
the deployment guide on the Wiki. However this is less than ideal for
printing reasons. Alternatively, we can look to hosting all
documentation in DocBook, though this makes the Wiki less Wiki like.
Publican seems to be a popular option for document publishing.
(
https://fedorahosted.org/publican/wiki/UsersGuide). It has the
disadvantage of being XML, though I think this still may be a bit better
for getting contributions than something like LaTEX.
Is this something we can tie into Mike Mcgrath's CSI project?
https://fedorahosted.org/csi/wiki/FAQ
--
Stephen J Smoogen. -- BSD/GNU/Linux
How far that little candle throws his beams! So shines a good deed
in a naughty world. = Shakespeare. "The Merchant of Venice"