On 18 Nov 2001 [EMAIL PROTECTED] wrote: This is exactly the kind of improvement I'd like to suggest caused by an talk I had with a customer last week. New people are reading that page first and are moving away because of certain statements there (because they are used to read IBM or MS product pages):
On the http://xml.apache.org/cocoon2 page we say that "This documentation is alpha, so don't expect that much." but we should reduce this negative statement now to something like "This documentation might not be totally complete". Also we say there "If you are not a developer and you are not willing to test new stuff that may not work as expected, we suggest you to refer to the latest Cocoon 1 release which is very stable." but I don't think we should encourage people to still move on to 1.8.x because: 1. we don't have any version 1 developers/knowledge here ATM to support people taking the 1.8 way as suggested on the page. 2. version 2.0 is stable enought to encourage people to stay. 3. the user lists shows that there are many people/knowledge there to help new people to start. Don't you agree? Giacomo > crossley 01/11/17 20:43:52 > > Modified: documentation/xdocs/developing index.xml > documentation/xdocs/userdocs index.xml > documentation/xdocs/userdocs/actions actions.xml > documentation/xdocs/userdocs/xsp index.xml > Log: > Minimise the "Under Construction" type of notice. > > Revision Changes Path > 1.3 +4 -2 xml-cocoon2/documentation/xdocs/developing/index.xml > > Index: index.xml > =================================================================== > RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/developing/index.xml,v > retrieving revision 1.2 > retrieving revision 1.3 > diff -u -r1.2 -r1.3 > --- index.xml 2001/10/25 14:58:42 1.2 > +++ index.xml 2001/11/18 04:43:51 1.3 > @@ -13,8 +13,10 @@ > <body> > <s1 title="Overview"> > > - <p> > - Here will soon appear all the developer documentation. > + <p>Here will soon appear an overview of the developer perspective. > + </p> > + > + <p>The actual developer documentation is available from the side-panel. > </p> > > </s1> > > > > 1.4 +4 -2 xml-cocoon2/documentation/xdocs/userdocs/index.xml > > Index: index.xml > =================================================================== > RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/userdocs/index.xml,v > retrieving revision 1.3 > retrieving revision 1.4 > diff -u -r1.3 -r1.4 > --- index.xml 2001/10/04 08:24:37 1.3 > +++ index.xml 2001/11/18 04:43:51 1.4 > @@ -13,8 +13,10 @@ > <body> > <s1 title="Overview"> > > - <p> > - Here will soon appear all the user documentation. > + <p>Here will soon appear an overview of the user perspective. > + </p> > + > + <p>The actual user documentation is available from the side-panel. > </p> > > </s1> > > > > 1.3 +6 -4 xml-cocoon2/documentation/xdocs/userdocs/actions/actions.xml > > Index: actions.xml > =================================================================== > RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/userdocs/actions/actions.xml,v > retrieving revision 1.2 > retrieving revision 1.3 > diff -u -r1.2 -r1.3 > --- actions.xml 2001/10/25 07:49:13 1.2 > +++ actions.xml 2001/11/18 04:43:52 1.3 > @@ -17,10 +17,12 @@ > <p>This document lists all available actions of Apache Cocoon >and > describes their purpose.</p> > </s1> > - <s1 title="Overview"> > - <p>Forthcoming... > - </p> > - </s1> > + > + <s1 title="Overview"> > + <p>See the concepts document > + <link href="../actions.xml">Creating and Using Actions</link>. > + </p> > + </s1> > <s1 title="The Actions in Apache Cocoon"> > <p>Forthcoming... > </p> > > > > 1.3 +4 -1 xml-cocoon2/documentation/xdocs/userdocs/xsp/index.xml > > Index: index.xml > =================================================================== > RCS file: /home/cvs/xml-cocoon2/documentation/xdocs/userdocs/xsp/index.xml,v > retrieving revision 1.2 > retrieving revision 1.3 > diff -u -r1.2 -r1.3 > --- index.xml 2001/10/25 14:58:43 1.2 > +++ index.xml 2001/11/18 04:43:52 1.3 > @@ -14,7 +14,10 @@ > <s1 title="Overview"> > > <p> > - Here will soon appear all the user documentation for XSP. > + Here will soon appear an overview of the user perspective of XSP. > + </p> > + > + <p>The actual user documentation is available from the side-panel. > </p> > > </s1> > > > > > ---------------------------------------------------------------------- > In case of troubles, e-mail: [EMAIL PROTECTED] > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, email: [EMAIL PROTECTED]
