cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From giacomo <giac...@apache.org>
Subject Re: cvs commit: xml-cocoon2/documentation/xdocs/userdocs/xsp index.xml
Date Sun, 18 Nov 2001 10:25:38 GMT
On 18 Nov 2001 crossley@apache.org 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:     webmaster@xml.apache.org
> To unsubscribe, e-mail:          cocoon-cvs-unsubscribe@xml.apache.org
> For additional commands, e-mail: cocoon-cvs-help@xml.apache.org
>
>
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message