How about... * Cocoon Fundamentals (What you must absolutelty know to get Cocoon running) * Advanced configuration (Now that I got it running, let's give Cocoon something to do, a first project type of thing) * Introduction to Cocoon App Development (I've written my first pipeline, I want to develop my first application, which doesn't necessarily include Avalon components just yet) * Advanced Development with Cocoon (How to integrate Avalon directly into a Cocoon project, stuff that is needed for more advanceed application development. how do I change a component if I need to? The question then becomes, where do we draw the line between beginning and advanced development application) * Cocoon internals (What are the available commands for the esql transformer)
On 05/15/02 4:10, "TREGAN Fabien" <[EMAIL PROTECTED]> wrote: > > One of the main problem I hade when I started using "web documented" project > (it was CSS docs, XML/DOM, XSL, tomcat, I was young :) was to find a doc I > can understand. > Later, my problem was to find a doc without all that newbies blabla. > > So I think that best topics grouping is the intended-audience-groumpings. > > > Another problem with cocoon is that you must learn three differents things : > 1- cocoon concepts (pipelines, sourceHandlers, ...) > 2- Avalon concepts (pools, roles, parameters, ...) > 3- realworld practice (ok, i know what's a pipeline, but how do I getthis > to works) > Of course, everyone is able to understand the following sentence : "Since > the cinclude transformer use urls that are handled by the cocoon > SourceHandler component, if you have an avalon source that is XMLizable, you > can use it with cocoon cinclude transformer provided that you registered the > sourcefacotry of your source with the sourceHandler in the sitemap, and then > cocoon will benefit from your source being (avalon)cacheable, and use avalon > pooling system if your source is not threadsafe. [1]" > > But /understand/ a sentence does not mean /learn/ from it. > > > So, in my opinion, actual docs should be grouped like this : > > ---Discover Cocoon--- > > -Basic cocoon feature > -sitemap > -matchers & selectors > -generators (file) > -transformers (xslt) > -Basic "avalon" feature > -caching > -parameters > -Advanced cocoon features > -views > -persistence > > > ---RealWorld Cocoon--- > > -other generators > -request > -... > -other tranformers > -I18N > -... > -Databases > -... > > > ---Cocoon Extensions--- > > -Sunshine > -scratchpade things > -... > > > ---Extending Cocoon--- > > -How to code Cocoon Component > -How to deploy Cocoon Component > -tutorial (with separated infos about Cocoon concepts and Avalon concepts) > > > Hope this help. Maybe a lot of mistake, but main idea is there :) > > fabien. > > > > [1] quote from the tutorial i'm working on... wip :) > >> -----Message d'origine----- >> De: Diana Shannon [mailto:[EMAIL PROTECTED]] >> Date: mercredi 15 mai 2002 12:26 >> À: [EMAIL PROTECTED] >> Objet: [doc] volunteer, grouping topics >> >> >> Would someone like to help decide meaningful grouping topics for >> Cocoon-related documents? I started to do this for the revised FAQ >> documents, based on existing FAQ content. It needs to be expanded and >> revised. Perhaps someone could expand/edit what I've started >> and post to >> this list for comments/revisions. I'd like to use it for all >> documents, >> including snippets, tutorials, and how-tos. >> >> Thanks a lot. >> >> Diana >> >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [EMAIL PROTECTED] >> For additional commands, email: [EMAIL PROTECTED] >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, email: [EMAIL PROTECTED] > -- Carlos E. Araya ---+ WebCT Administrator/Trainer P | California Virtual Campus - | C/O De Anza College G | 21250 Stevens Creek Blvd ---+ Cupertino, CA 95014 email [EMAIL PROTECTED] web http://www.cvc1.org/ (work) http://www.silverwolf-net.net (personal) phone 408 257 0420 (work) PGP Fingerprint: E629 5DFD 7EAE 4995 E9D7 3D2F 5A9F 0CE7 DFE7 1756 "If there is artificial intelligence, doesn't that imply there is also artificial stupidity!" --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, email: [EMAIL PROTECTED]