One of my ongoing concerns is whether the documentation available to Cobbler makes sense, is easy to read, and folks can find out the questions they want to know. I think over the past several months we've built up a large amount of docs on the Wiki and made that a primary source for information. That all being said, I'm not the best to evaluate it because of preconceptions about what it already says :)
What probably hasn't gotten the most attention is the manpage -- Since we've reordered the fields and added lots of new features, recently, I've made some edits to the manpage, and think it would be a good time for those that depend on it to review things to see if they make sense (particularly, if you can, pretend you were reading things for the first time).
To save you the trouble of building the manpage, anyone with Perl installed (read: everyone) can do:
wget "http://git.fedorahosted.org/git/cobbler?p=cobbler;a=blob_plain;f=docs/cobble..." -O output.pod perldoc output.pod
I would also be interested in comments about the Wiki documentation, stumbling blocks you encountered when learning what cobbler does, or problems your coworkers might have encountered when you showed it to them for the first time.
One thing I note, in particular, is it still makes some references to Fedora Core 6 which should most definitely be replaced with F9 :)
Comments welcome.
--Michael
cobbler@lists.fedorahosted.org