Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-21 Thread Jeremy Quinn
At 17:44 +0200 16 04 2002, Christian Haul wrote: >One thing that bugs me especially is links between docs. Currently >this is done by pointing to the place the generated HTML will end >up. Would be great if we could do better (no idea though, XPointer?) We might try XLink, we could get something

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-20 Thread David Crossley
Stefano Mazzocchi wrote: > Ladies and Gentlemen, > > this is a somewhat atypical request for vote so it requires a deeper and > more detailed explaination. >

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Ovidiu Predescu
On Wed, 17 Apr 2002 09:01:48 +0200, TREGAN Fabien <[EMAIL PROTECTED]> wrote: > > 3. Avoid use of colloquialisms (common expressions in English that > >non-native speakers may fail to understand) > > etc. > > 4. avoid common expressions in English that > non-native speakers may fail to und

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread TREGAN Fabien
>-Message d'origine- >De: Diana Shannon [mailto:[EMAIL PROTECTED]] > >Examples include guidelines like > 1. One sentence, one idea. > 2. Active over passive voice. > 3. Avoid use of colloquialisms (common expressions in English that >non-native speakers may fail to understand) >

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Carsten Ziegeler
Definitly a big +1 for having a 'documentation coordinator' and another +1 for you Diana doing this job. I would like to add another important point to the "job description": * Updating the Cocoon Web Site (= deploying new documentation). Cheers Carsten Stefano Mazzocchi wrote: > > Ladies an

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread giacomo
On Tue, 16 Apr 2002, Diana Shannon wrote: > > Giacomo wrote: > > > > >> 8. Develop style guide and author's tips for all future submissions. > > > > How does the Forrest project play into this? > > I have been lurking on the Forrest list for a while now as well. > > By style guide, I am referring

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Ivelin Ivanov
Message - From: "Stefano Mazzocchi" <[EMAIL PROTECTED]> To: "Apache Cocoon" <[EMAIL PROTECTED]> Sent: Tuesday, April 16, 2002 7:23 AM Subject: [vote] Diana Shannon as Documentation Coordinator > Ladies and Gentlemen, > > this is a somewhat atypical req

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread David Crossley
John Morrison wrote: > Diana Shannon wrote > > Nick Airey wrote: > > > > > I vote for giving her commit access. Anyway, we can always > > > roll back the > > > versions in cvs if something goes too far off the rails. Not that > > > I think it will. > > > > If I were making edits, I'd run them by t

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Diana Shannon
Giacomo wrote: > >> 8. Develop style guide and author's tips for all future submissions. > > How does the Forrest project play into this? I have been lurking on the Forrest list for a while now as well. By style guide, I am referring to editorial and copy style, not presentation style. These

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Nicola Ken Barozzi
From: "Steven Noels" <[EMAIL PROTECTED]> > One of the things we should get started with is to bring the documents > into sync with the v1.1 xdoc DTD's in Forrest - I'll give them a quick > look tomorrow and see if they need urgent changes. That way, we are > Forrest-ready when Forrest is ready :-

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread John Morrison
> From: Diana Shannon [mailto:[EMAIL PROTECTED]] > > Nick Airey wrote: > > > I vote for giving her commit access. Anyway, we can always roll back the > > versions in cvs if something goes too far off the rails. Not that I > > think it will. > > If I were making edits, I'd run them by the original

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Steven Noels
(uh-oh, it seems I was missing out the fun during the past few days) Diana, congrats, it seems like you gathered enough votes. > 9. Recruit/invite other editors/authors/reviewers to assist > with ongoing > effort > > Down the road, point 9 for me is crucial. I'm probably going > to be the > kin

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread giacomo
On Tue, 16 Apr 2002, Diana Shannon wrote: > > Nick Airey wrote: > > > I vote for giving her commit access. Anyway, we can always roll back the > > versions in cvs if something goes too far off the rails. Not that I > > think it will. > > If I were making edits, I'd run them by the original author

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread giacomo
On Tue, 16 Apr 2002, Diana Shannon wrote: > > > So, Diana, please, introduce yourself and introduce your plan of action > > (as you did with me privately) so that the rest of the community can > > vote. > > I've been happily working with Cocoon (1 and 2) for the past eighteen > months. My clients

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread giacomo
On Tue, 16 Apr 2002, Stefano Mazzocchi wrote: > Ladies and Gentlemen, > > this is a somewhat atypical request for vote so it requires a deeper and > more detailed explaination. > > Cocoon has reached a point where its technical quality has far exceeded > its overall 'usability', in the sense of t

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Bernhard Huber
hi, +1 from me of course - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, email: [EMAIL PROTECTED]

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Gianugo Rabellino
Torsten Curdt wrote: > > >>Thanks for your consideration. Please let me know if you need any >>additional information. > > > nope ;) ...here is my +1 And this is my +1. Together with an offer for help: I was already planning something about Cocoon docs, it's really great to have someone to

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Nicola Ken Barozzi
From: "Diana Shannon" <[EMAIL PROTECTED]> > Sylvain Wallez wrote: > > > > Don't forget Vadim, the Lord of Cocoon-users :) > > Many users would be entirely lost without Vadim. I still find it hard to > believe he's a single entity, not an alias for several others! ;) FYI: http://marc.theaimsgro

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Diana Shannon
Nick Airey wrote: > I vote for giving her commit access. Anyway, we can always roll back the > versions in cvs if something goes too far off the rails. Not that I > think it will. If I were making edits, I'd run them by the original authors for comments/criticism before committing. I would als

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Diana Shannon
Sylvain Wallez wrote: >> >> 4) managing relationships between users and developers >> > > Don't forget Vadim, the Lord of Cocoon-users :) Many users would be entirely lost without Vadim. I still find it hard to believe he's a single entity, not an alias for several others! ;) Diana

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Ovidiu Predescu
+1! Diana has a hard job in front of her, I hope she'll survive after it! Regards, Ovidiu On Tue, 16 Apr 2002 14:23:14 +0200, Stefano Mazzocchi <[EMAIL PROTECTED]> wrote: > Ladies and Gentlemen, > > this is a somewhat atypical request for vote so it requires a deeper and > more detailed expla

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Torsten Curdt
> Thanks for your consideration. Please let me know if you need any > additional information. nope ;) ...here is my +1 -- Torsten - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, email: [EMAIL PROTECTED]

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Butler, Mark
> -Original Message- > From: Stefano Mazzocchi [mailto:[EMAIL PROTECTED]] > Sent: 16 April 2002 13:23 > To: Apache Cocoon > Subject: [vote] Diana Shannon as Documentation Coordinator +1 This sounds like a good idea. best regards Mark H. Butler, PhD Research Scientist

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Gerhard Froehlich
+1000 ~Gerhard - Me, Ambivalent? Well, yes and no. - >-Original Message- >From: Stefano Mazzocchi [mailto:[EMAIL PROTECTED]] >Sent: Tuesday, April 16, 2002 2:23 PM >To: Apache Cocoon >Subject: [vote] D

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Nick Airey
+1 thanks Diana! > Ah, one more thing: she asked me if the community needed samples of her > skills to provide a vote and I admit it's a little strange to ask to > give commit access to somebody without having to do anything. I vote for giving her commit access. Anyway, we can always roll back

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Robert Koberg
Hi! This is great news. Hopefully Diana will accept! She sounds perfect for the job and most of the developers so far have seen the need to keep docs up-to-date. Christian Haul wrote: >> 2) coordinating the authoring effort (means: kicking some asses if >>people commit code without committing

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Vadim Gritsenko
> From: Stefano Mazzocchi [mailto:[EMAIL PROTECTED]] > > Ladies and Gentlemen, > > this is a somewhat atypical request for vote so it requires a deeper and > more detailed explaination. > > Cocoon has reached a point where its technical quality has far exceeded > its overall 'usability', in the

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Christian Haul
On 16.Apr.2002 -- 02:23 PM, Stefano Mazzocchi wrote: > 1) planning and proposing a better (as defined above) documentation > outline +1 Esp. having templates and skeletons ("place documentation about XYZ here") would be great. Although the DTD for xdoc has some comments I do wonder sometimes a

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Sylvain Wallez
Stefano Mazzocchi wrote: >Ladies and Gentlemen, > >this is a somewhat atypical request for vote so it requires a deeper and >more detailed explaination. > >Cocoon has reached a point where its technical quality has far exceeded >its overall 'usability', in the sense of the ability for users to 'u

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Diana Shannon
> So, Diana, please, introduce yourself and introduce your plan of action > (as you did with me privately) so that the rest of the community can > vote. I've been happily working with Cocoon (1 and 2) for the past eighteen months. My clients and I love it. As a user, however, its frustrating to

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Konstantin Piroumian
From: "Stefano Mazzocchi" <[EMAIL PROTECTED]> > Ladies and Gentlemen, > ... > > I've been approached by Diana Shannon who has volunteered to step in and > help with the process of creating a better documentation. She explained > to me her intentions, her skills and her 'devotion to the cocoon caus

RE: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Morrison, John
> From: Stefano Mazzocchi [mailto:[EMAIL PROTECTED]] > > Ladies and Gentlemen, > > this is a somewhat atypical request for vote so it requires a > deeper and > more detailed explaination. > > Cocoon has reached a point where its technical quality has > far exceeded > its overall 'usability',

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Torsten Curdt
On Tue, 16 Apr 2002, Stefano Mazzocchi wrote: > I've challenged her offering a 'documentation coordinator' job overhere. > Just like we have a 'release coordinator', I think it makes sense to > have a 'documentation coordinator'. great! > The job includes: > > 1) planning and proposing a bet

Re: [vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Nicola Ken Barozzi
From: "Stefano Mazzocchi" <[EMAIL PROTECTED]> > I've been approached by Diana Shannon who has volunteered to step in and > help with the process of creating a better documentation. She explained > to me her intentions, her skills and her 'devotion to the cocoon cause' > (so to speak :). > > I've

[vote] Diana Shannon as Documentation Coordinator

2002-04-16 Thread Stefano Mazzocchi
Ladies and Gentlemen, this is a somewhat atypical request for vote so it requires a deeper and more detailed explaination. Cocoon has reached a point where its technical quality has far exceeded its overall 'usability', in the sense of the ability for users to 'use the system for their needs'.