Stephen John Smoogen wrote: > On Mon, Jul 28, 2008 at 12:08 PM, Michael DeHaan <[EMAIL PROTECTED]> 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 _______________________________________________ cobbler mailing list [email protected] https://fedorahosted.org/mailman/listinfo/cobbler
