[PATCH][C2] Documentation

[Tom Klaasen <To...@the-ecorp.com>]

Hi everybody,

I've made an effort to make a "starter's documentation". This means I've
tried to make a documentation that a Java programmer (with some experience
in servlets, html, and the lot) could get a grip as fast as possible on
Cocoon 2. This does not mean that, after he has read this docs, he knows
Cocoon in depth, but he has an overview of the concepts.

I wrote this because in my experience, this was the most lacked in the
existing documentation. The specialized parts are in general good described,
but not the technical overview of C2.

As you will see, parts are not written by myself but are just copied from
various places in the C2 cvs tree. Putting it all together adds value, imho.

The documentation includes:
- A detailed step-by-step to checkout C2 from CVS (under win*). This is
because in my company, many people (and not the most stupid ones!) were
interested in C2, but lost interest because they had no experience with CVS.
If they can checkout the lot, they could have a look at it, and if they get
interested then, they could learn more advanced CVS.
- An overview. This describes the pipeline architecture.
- A "HttpRequest" document: How does C2 gets initialized, and what happens
if a HTTPRequest arrives at the servlet engine? This is the main part, as it
helps to get a grip on the "when and why" of the various concepts of C2.
- The Avalon concepts that are used in C2. You should be able to learn C2
without having to learn Avalon in its entirety.
- "Extending" tries to give an idea of when to extend which parts of C2, for
your needs. It also gives an overview of already existing components.
- "XSP": a guideline of where to find documentation about C2 (the link to
Stefano's slides was what I missed the most)

I hope you guys appreciate this. Any feedback (corrections/additions/...) is
always welcome.

(Most of the files are new files, the .diff files are diff'ed from cvs)

Ciao,

tomK

xml-logicsheet instead of xml-stylesheet - pi !

[Gabi Brysch <br...@inxnet.de>]

[PATCH][C2] Documentationhi,

[win2000, jdk1.3, jsdk2.2, cocoon1.8, tomcat3.1]

i refer to the faq on page:
  http://xml.apache.org/cocoon/faqs.html#faq-logicsheet


  there is a solution for using xml-logicsheet pi instead of xml-stylesheet
pi, for the case the xsp-page can be recompiled. but if i just replace

              <?xml-stylesheet href="myTransformation.xsl" type="text/xsl"?>
  with:    <?xml-logicsheet href="myTransformation.xsl" type="text/xsl"?>

  the error-message: no matching stylesheet for explorer is being displayed
!!


  i have a case like:

      producing xml with my own producer
      applying a xsl-transformation which is a xsp-page to add information
to the produced xml-file
      than applying another stylesheet which converts the xml to xhtml.

  now i'm not sure how to use the pi:    <?xml-logicsheet
href="myTransformation.xsl" type="text/xsl"?>

  have i use the pi : <?cocoon-process type="xslt"?> as well -- or is there
another one for logicsheets ???


  is there another example then the clean-page.xml ???


  thanks,

  GABI