On Thursday, December 22, 2011 at 10:00 AM, David Lee wrote:
Michael DeHaaan wrote:For those that are interested in helping with docs, manage docs arenow ported over to the Wiki, in a few parts.This is pretty much most of the manage, which I think should stay moreor less together. If you split things into too many Wiki pages, it'shard to absorb things via osmosis. I would like to mix the examples incloser to the job though and incorporate more examples throughout, so ifyou're a new user you don't get bored/confused and wonder what commandsyou actually care about running. [...]Great! Thanks, Michael.As this is a "Start here" document, it should be simple and clear, andavoid unnecessary detail, particular in its opening stages.I began editing it......but ended up almost completely rewriting the opening sections,through to and including the opening paragraphs of "addingdistributions". The emphasis is on getting a complete beginner startedwith something, anything, and avoiding unnecessary detail.I haven't really addressed the remainder of the document; my changes inthe remainder are mostly cosmetic, improving heading/subheadingstructure, etc.Returning to "adding distributions". While the original man page hadthoroughly documented "cobbler distro ...", it hadn't (by contrast) gota section on "cobbler import ..." at all. So I have begun to structurethis "adding distributions" sections to cover these related topics. ButI strongly suspect that most of the options for "distro" also apply to"import", so it probably needs further restructuring to clarify this.(By the way, more generally, I'm not yet convinced that every lastdetail of every last option for every last command belongs in a "Starthere" document...)-- David Lee_______________________________________________cobbler mailing list