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
