Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-14 Thread Reinhard Poetz
Sebastien Arbogast wrote: I don't mean the docs have to be made up of small chunks, but it must be possible to do useful work on them in small amounts of time (which is perfectly possible with the 2.2 docs system). Let's think in terms of network architecture and layers. I personally think that wh

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-14 Thread Bertrand Delacretaz
Le 14 avr. 05, à 13:29, Sebastien Arbogast a écrit : ...When you want to go from one side of the river to the other side, you can dive and swim, or you can quickly build a pirogue that will be more efficient, that will be able to carry many more people and scare far less Ok, let's see this pir

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-14 Thread Sebastien Arbogast
> I don't mean the docs have to be made up of small chunks, but it must > be possible to do useful work on them in small amounts of time (which > is perfectly possible with the 2.2 docs system). Let's think in terms of network architecture and layers. I personally think that what Reinhard and Upay

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-14 Thread Bertrand Delacretaz
Le 14 avr. 05, à 07:47, Sebastien Arbogast a écrit : So a crucial point is that any docs effort/tool/whatever has to allow us to work in small increments and be useful, without leaving half-finished work behind us. Something requiring big stretches of continuous work is useless ATM. And still... no

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
> So a crucial point is that any docs effort/tool/whatever has to allow > us to work in small increments and be useful, without leaving > half-finished work behind us. Something requiring big stretches of > continuous work is useless ATM. And still... now I can realize how learning how to use a po

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Bertrand Delacretaz
Le 13 avr. 05, à 07:10, Sebastien Arbogast a écrit : ...FTR, I should precise that right now I'm working on a big project using Cocoon as its core XML server and it's my first project using Cocoon, which implies that -> I won't be able to spend my whole days on this... And this is a key point: AFAI

RE: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Linden H van der (MI)
IL PROTECTED] > Sent: Wednesday, 13 April, 2005 12:04 > To: dev@cocoon.apache.org > Subject: Re: "Apache Cocoon in Action" suggestion and call > for opinions > > > > Sounds great. At some point, we've got to come up with a > list of the > > sort o

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
> Sounds great. At some point, we've got to come up with a list of the > sort of tutorials and walk-throughs we want, so that we can have > comprehensive coverage. In the meantime, I'd say just go ahead and write it! or let's try to see if it can't be part of sort of a bigger complete tutoria

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Upayavira
Linden H van der (MI) wrote: Hi, sorry I've been too busy lately to participate in anything I've promised over time. It's not that I don't want to do it any more, just time... well, you know. Reading this thread, something clicked as I've been working on a simple website using Cocoon with simple XM

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
> I could try and write down the process I've gone through and using that > as a base for a tutorial for "MyFirstCocoonWebApp". I know I sometimes > work backwards (i.e. develop first, think later ;-)), so things might be > out of (efficient) order. > > The website I'm referring to is currently on

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Upayavira
Bertrand Delacretaz wrote: Le 13 avr. 05, Ã 10:30, Upayavira a Ãcrit : ...2) What myself and Reinhard have conceived is a container for ALL docs. We need first of all to bring the reference docs across, and to scrap a lot of the crud that has built up over the years. That, I hope, will establish

RE: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Linden H van der (MI)
nal Message- > From: Upayavira [mailto:[EMAIL PROTECTED] > Sent: Wednesday, 13 April, 2005 10:30 > To: dev@cocoon.apache.org > Subject: Re: "Apache Cocoon in Action" suggestion and call > for opinions > > > Sebastien, > > I know Reinhard has said a lot

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Bertrand Delacretaz
Le 13 avr. 05, à 10:30, Upayavira a écrit : ...2) What myself and Reinhard have conceived is a container for ALL docs. We need first of all to bring the reference docs across, and to scrap a lot of the crud that has built up over the years. That, I hope, will establish a foundation upon which we

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Upayavira
Sebastien, I know Reinhard has said a lot already. I just wanted to make a few comments. 1) Thanks for coming over to the dev list. It is the best place for these discussions as all developers will be reading what it said. 2) What myself and Reinhard have conceived is a container for ALL docs.

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Thorsten Scherler
On Wed, 2005-04-13 at 09:37 +0200, Reinhard Poetz wrote: > Sebastien Arbogast wrote: > > I don't know how forrest works yet but is it possible to have a global > > PDF for a whole part of documentation. For example is it possible to > > generate automatically a PDF book containing all the Cocoon >

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Reinhard Poetz
Sebastien Arbogast wrote: I don't know how forrest works yet but is it possible to have a global PDF for a whole part of documentation. For example is it possible to generate automatically a PDF book containing all the Cocoon documentation in one file ? yes it is, but I haven't figured it out yet m

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
I don't know how forrest works yet but is it possible to have a global PDF for a whole part of documentation. For example is it possible to generate automatically a PDF book containing all the Cocoon documentation in one file ? On 4/13/05, Reinhard Poetz <[EMAIL PROTECTED]> wrote: > Sebastien Arbo

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Reinhard Poetz
Sebastien Arbogast wrote: So the new 2.2 documentation base is in whiteboard or trunk ? in trunk: http://svn.apache.org/repos/asf/cocoon/trunk/src/documentation -- Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach {Software Engineering, Open Source, Web Applications, Apache Coc

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
Ok it's alright I just checked your update on the wiki. Pfio it's late here in montreal, maybe I should go to bed... ;o) On 4/13/05, Sebastien Arbogast <[EMAIL PROTECTED]> wrote: > So the new 2.2 documentation base is in whiteboard or trunk ? > > On 4/13/05, Reinhard Poetz <[EMAIL PROTECTED]>

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
So the new 2.2 documentation base is in whiteboard or trunk ? On 4/13/05, Reinhard Poetz <[EMAIL PROTECTED]> wrote: > Sebastien Arbogast wrote: > > Just to precise a little point that is not explicitly precised in the wiki. > > To download the sources of Cocoon 2.2, I do a checkout on this URL : >

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Reinhard Poetz
Sebastien Arbogast wrote: Just to precise a little point that is not explicitly precised in the wiki. To download the sources of Cocoon 2.2, I do a checkout on this URL : http://svn.apache.org/repos/asf/cocoon/trunk/ ? that's correct (will add it to the wiki) Or is it in the whiteboard directory at

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-13 Thread Sebastien Arbogast
Just to precise a little point that is not explicitly precised in the wiki. To download the sources of Cocoon 2.2, I do a checkout on this URL : http://svn.apache.org/repos/asf/cocoon/trunk/ ? Or is it in the whiteboard directory at top level ? On 4/13/05, Reinhard Poetz <[EMAIL PROTECTED]> wrote:

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Reinhard Poetz
Sebastien Arbogast wrote: Oh yes I totally agree with that. As a matter of format and technical infrastructure, it is the best solution and we could just make a new documentation branch at the top level. What I meant by "in parallel" I had content progression in mind, just to be sure that new users

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Sebastien Arbogast
Oh yes I totally agree with that. As a matter of format and technical infrastructure, it is the best solution and we could just make a new documentation branch at the top level. What I meant by "in parallel" I had content progression in mind, just to be sure that new users could see the difference

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Reinhard Poetz
Sebastien Arbogast wrote: Why in parallel? Look at http://brutus.apache.org/docs/build/cocoon-2-2/. This build already contains an improved structure that is similar to yours that reflects Cocoon 2.2 in a better way than the current 2.1 docs do (although Upayavira and I discussed this for hours, th

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Sebastien Arbogast
> Why in parallel? Look at http://brutus.apache.org/docs/build/cocoon-2-2/. This > build already contains an improved structure that is similar to yours that > reflects Cocoon 2.2 in a better way than the current 2.1 docs do (although > Upayavira and I discussed this for hours, this doesn't mean th

Re: "Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Reinhard Poetz
Sebastien Arbogast wrote: Moreover this documentation could be written and reviewed in parallel and tight collaboration with the new Cocoon 2.2 documentation effort to make sure that the information is accurate and exact and to keep stuff in sync. And it could be written and reviewed/corrected pro

"Apache Cocoon in Action" suggestion and call for opinions

2005-04-12 Thread Sebastien Arbogast
Hi, I may have something to suggest concernig the new documentation effort. The main problem that I had to face while begining to work with Cocoon was the enormous gap between the level of the first tutorials I found on the wiki or other sources like theserverside.com or IBM DeveloperWorks. I mean