From the ongoing discussion we (the users) stated, that : * currently the docs do not really separate between cocoon-users and cocoon-developers and cocoon doesn't imply an obvious separation.
* the documentation seems to be more developer centric, less user centric. * especially the newbies often get into trouble, because they feel, they have to learn the concepts in depths before they can get someth8ing out of cocoon. therefore we started this "newbies competence center" approach. i personnaly whish, that eventually the whole cocoon documentation will be better separated into developers issues and users issues, where my definition (biased from the discussions) is a bit fuzzy: user: *uses* the given infrastructure as is developer: *creates* his own add ons to given infrastructure I get troubles when it comes to xsp programming, which clearly sits between the chairs. But even there i see a bunch of prepacked ready to use logicsheets ready made for the "users" and the self made extra logicsheets from the developers... maybe this is a little simplistic, but it may hold as a first approach towards separating user concerns from developer concerns. another argument was: the user does not deal with internals nor with philosophy under the hood (like avalon framework, etc.) The developer in contrary does. But even here there seem to be at least two kinds of developers at work: those who do "simple" add ons (whatever simple means) i name them "application programmers" (they won't dive deep into avalon) and those who create complex additions to the cocoon base, who may be labeled as system programmers. all of this is not so easy and should be separated out more clearly in the next steps. I am pretty shure, if we keep with KISS, we should come out at least with a usable beginners doc though ;-) regards, hussayn Tony Collen wrote:
Remember, the docs are for the users, and unfortunately, the developers might have a different idea about how the information "should" be categorized. Or maybe our problem is making the distinction between "users" and "developers" ... I would guess that eventually, most users become developers, so then, it's just a matter of "beginning user" vs. "power user", and so on.
-- Dr. Hussayn Dabbous SAXESS Software Design GmbH Neuenhöfer Allee 125 50935 Köln Telefon: +49-221-56011-0 Fax: +49-221-56011-20 E-Mail: [EMAIL PROTECTED] --------------------------------------------------------------------- Please check that your question has not already been answered in the FAQ before posting. <http://xml.apache.org/cocoon/faq/index.html> To unsubscribe, e-mail: <[EMAIL PROTECTED]> For additional commands, e-mail: <[EMAIL PROTECTED]>
