Re: bored with *talks* about docs (was: New documentation project?)

2004-12-01 Thread David Crossley
Joerg Heinicke wrote: [EMAIL PROTECTED] wrote: OK, I'll sing a chorus. As it happens, I spent the weekend constructing documentation on the Cocoon Portal, trying to fill in some holes and allow for people who aren't familiar with Cocoon and the pipeline paths specific to the Portal. Still a ways

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-23 Thread Joerg Heinicke
On 23.11.2004 07:27, Derek Hohls wrote: Joerg Could you supply the actual URL of the DTD itself... all I could find pages discussing changes to the DTD. I guess you have been viewing the correct file - it only includes the other parts, look at the end of the file. But v10 is more obvious:

RE: bored with *talks* about docs (was: New documentation project?)

2004-11-23 Thread Tim.Holloway
Thanks! -Original Message- From: Joerg Heinicke [mailto:[EMAIL PROTECTED] Sent: Monday, November 22, 2004 5:05 PM To: [EMAIL PROTECTED] Subject: Re: bored with *talks* about docs (was: New documentation project?) On 22.11.2004 22:43, [EMAIL PROTECTED] wrote: OK, I'll sing

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-23 Thread Derek Hohls
And to view v10 requires: http://svn.apache.org/viewcvs.cgi/forrest/branches/FORREST_05_BRANCH/src/resources/schema/dtd/v10/document-v10.dtd?view=markup [EMAIL PROTECTED] 2004/11/23 11:03:04 AM On 23.11.2004 07:27, Derek Hohls wrote: Joerg Could you supply the actual URL of the DTD

RE: bored with *talks* about docs (was: New documentation project?)

2004-11-22 Thread Tim.Holloway
. Thanks, Tim Holloway -Original Message- From: Bertrand Delacretaz [mailto:[EMAIL PROTECTED] Sent: Saturday, November 13, 2004 8:29 AM To: [EMAIL PROTECTED] Subject: Re: bored with *talks* about docs (was: New documentation project?) Le 13 nov. 04, à 14:21, Upayavira a écrit

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-22 Thread Joerg Heinicke
On 22.11.2004 22:43, [EMAIL PROTECTED] wrote: OK, I'll sing a chorus. As it happens, I spent the weekend constructing documentation on the Cocoon Portal, trying to fill in some holes and allow for people who aren't familiar with Cocoon and the pipeline paths specific to the Portal. Still a ways to

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-22 Thread Derek Hohls
Joerg Could you supply the actual URL of the DTD itself... all I could find pages discussing changes to the DTD. [EMAIL PROTECTED] 2004/11/23 12:05:03 AM On 22.11.2004 22:43, [EMAIL PROTECTED] wrote: OK, I'll sing a chorus. As it happens, I spent the weekend constructing documentation on

RE: bored with *talks* about docs (was: New documentation project ?)

2004-11-15 Thread H . vanderLinden
Do you mean that it's not as well written out as the extent to which you've thought it through? Or that you've already written out your own plan? No, the other way around: I never took the time to think it through and write it down to the extent you've done on that page. [...] but if you

RE: bored with *talks* about docs (was: New documentation project ?)

2004-11-14 Thread H . vanderLinden
Guys, I've been quiet on this one simply because I was too busy with the myriad of crises that required my attention. The Cocoon documentation project is still on the backburner, it's surely not cold. With a full-time job, a husband and two small kids, and a household on my plate, there is

Re: bored with *talks* about docs (was: New documentation project ?)

2004-11-14 Thread Bertrand Delacretaz
Hi Helma, Thanks very much for your realistic comments and approach, I think this sums it up very nicely: ...my idea is to start small, accept that the process is slow, with countless start and stop times, when other projects need much more priority... The idea is to to leave something useful

RE: bored with *talks* about docs (was: New documentation project?)

2004-11-14 Thread David Leangen
(BHi, Helma, (B (BExcellent points and great ideas! (B (B (B I just read the ExtremeDocumentationOverhaul. Great, more or (B less what I had mind although not as well thought out and (B certainly not as well written out. (B (BDo you mean that it's not as well written out as the extent

bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Bertrand Delacretaz
Le 13 nov. 04, à 05:36, David Leangen a écrit : ...Not sure if I'm making myself clear, but I'm interested in hearing others' thoughts on this approach... You might want to take what follows with a grain of salt, please don't be offended. (First a bit of context to help you understand: it's a

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread beyaNet
Bertrand, I'm inclined to agree with your point of view. The community knows that things can be improved in terms of documenting cocoon so let's, instead of having the mother of all discussions about the blatantly self-evident, now concentrate on putting some flesh on this discussion. regards

RE: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread David Leangen
...Not sure if I'm making myself clear, but I'm interested in hearing others' thoughts on this approach... You might want to take what follows with a grain of salt, please don't be offended. Not offended at all. Good points and well said! :-) (Also, intentionally or not, appears to

RE: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread David Leangen
Don't ask around too much, you know the need and will is here - just do it, import the good parts of the existing docs (there *are* quite a lot of good parts actualy hidden in there) into whatever system you feel is good to use, create a live, tangible, concrete example of what the new docs

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Bertrand Delacretaz
Le 13 nov. 04, à 12:44, David Leangen a écrit : .. - can we have our own mailing list?.. don't think people would be offended if you discuss this here, maybe with a suitable header like [NEWDOCS] in the subject so people can filter it out if they want. In this way you'd have more visibility

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread beyaNet
David, time permitting, I would like to put my name forward. 'Cocoon - how do I?' regards Andrew On 13 Nov 2004, at 11:44, David Leangen wrote: Don't ask around too much, you know the need and will is here - just do it, import the good parts of the existing docs (there *are* quite a lot of good

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Bertrand Delacretaz
Le 13 nov. 04, à 12:39, David Leangen a écrit : ...(Also, intentionally or not, appears to support the idea of starting this out as a new, smaller project...) Starting outside might be a good idea to experiment freely - but for me, assuming good stuff comes out of this docs fork, it should move

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Upayavira
David Leangen wrote: Don't ask around too much, you know the need and will is here - just do it, import the good parts of the existing docs (there *are* quite a lot of good parts actualy hidden in there) into whatever system you feel is good to use, create a live, tangible, concrete example of

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Upayavira
beyaNet wrote: David, time permitting, I would like to put my name forward. 'Cocoon - how do I?' Great! As I said to David, why don't you take a look at http://wiki.apache.org/cocoon/Cocoon215TOC and see if there are any gaps you could fill in? The more of us work on this, the more we'll see

Re: bored with *talks* about docs (was: New documentation project?)

2004-11-13 Thread Bertrand Delacretaz
Le 13 nov. 04, à 14:21, Upayavira a écrit : ...You see, I think this will happen best if we use what we've got, and start small, rather than trying to create something new. The wiki isn't hard to use, and anyone who wants to can participate... +1, and the formats used today (xdocs and wiki) can