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/cobbler.pod;hb=devel";
 
-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 mailing list
[email protected]
https://fedorahosted.org/mailman/listinfo/cobbler

Reply via email to