Hi Micheal, One thing that i noticed is that some docs refer to /var/lib/cobbler as the config directory for settings (DHCP doc). It will also be more useful if we can add in an example. I was confused by the template that came with cobbler. wasn't sure which variables to keep. I am sure they were others who faced similar doubts while trying for the first time.
Will add in more comments as i run through the site while building my first cobbler server. Regards, Kiran On Wed, Jun 3, 2009 at 2:41 AM, Michael DeHaan <[email protected]> wrote: > It's time for me to go through the Wiki and scrub references to old > syntaxes, old cobbler versions, and so forth, and in general try to make > things more readable for new people. > I'm a bit blinded by some of it because I know the app too well, but for > those of you who have just picked things up recently, you are the ones > to ask this. > > Think about the first times you were reading through things on the Wiki > and the mainpage, and things you found confusing and hard to find. > > This is not another survey (yes, I'm due to report back on those results > from that one still), but in general I'm looking for information like... > > Do we need more examples on the Wiki? (On what topics?) > Should things be more cookbook like? > Are articles on certain things actually too long and confusing, or > actually too short (specific examples?) > Should I explain some concepts that I might be taking for granted? > Is the Wiki too flat, or too nested in terms of what you are trying to find? > Is there any obsolete content we just need to take out back and shoot > (some of the snippet examples, possibly, should just link to our > snippets as examples) > What things don't have documentation and you had to ask here or in the > channel about? > Are there particular settings that we don't explain but should? > > I know one thing I want to do for sure is write better examples for > pure-python triggers, and API examples, both in terms of the Python API > and XMLRPC. > > Developer docs should probably also mention the importance of individual > files better and how things are inter-related, without dwelling too much > on things that will quickly go out of date. > > Comments on docs both in terms of the Wiki and the mainpage are welcome. > > The goal is to not only make things easier to new users, but also make > it clear what all the advanced features are, and also show people how to > adopt those features and also /if/ they should adopt those features. > We don't want any particular things buried or not well documented. > > Thanks! > > --Michael > _______________________________________________ > cobbler mailing list > [email protected] > https://fedorahosted.org/mailman/listinfo/cobbler > _______________________________________________ cobbler mailing list [email protected] https://fedorahosted.org/mailman/listinfo/cobbler
