Stephen John Smoogen wrote:
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
I've talked with Mike about this. While I very much like the idea, it
seems CSI is about coming up with a list of specs with IEEE-RFC words
like "MUST" and "SHOULD" in them (i.e., selinux MUST be enabled,
SHOULD
be in permissive mode) in a common format, while I'm more wanting to
have a more general reference guide.
We could still have some CSI documentation for Cobbler (want to provide
some? I'd be more than happy to help review it).
--Michael