cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Morrison, John" <>
Subject RE: [vote] Diana Shannon as Documentation Coordinator
Date Tue, 16 Apr 2002 14:24:26 GMT
> From: 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'.


> Many are expressing their concerns about the fact that Cocoon is a
> developer framework, and the road to its use is normally so steep that
> very few can manage to get everything out of it.

Yep :(

> The best way to lower the gap is to have better docs. Better means:
>  1) more coherent
>  2) edited by people that knows the english language (since we use
> english as our default natural language) and have editing skills
>  3) maintained regularly
> 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 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'.
> The job includes:
>  1) planning and proposing a better (as defined above) documentation
> outline

She fancies the job? +100!

Go for it :)


>  2) coordinating the authoring effort (means: kicking some asses if
> people commit code without committing docs that go along with them: we
> might go as far as prohibiting code submissions, even in the 
> scratchpad,
> without appropriate documentation along)
>  3) providing editing of existing docs (and future docs)
>  4) managing relationships between users and developers
> I personally think Diana is great for this job becuase:
>  1) she volunteered (in my book, this would be enough since 
> nobody ever
> did in one of my projects after 5 years of more of OSS... but there is
> more)
>  2) her native language is English, but she has worked in many foreign
> countries and she speaks several languages.
>  3) she has a medium understanding of Cocoon as a user. No 
> developer can
> have this job since he/she would loose the user's point of 
> view. I think
> Diana can be a mix between the two points of view and 
> coordinate them so
> that they converge.
> All right, at this point I stop and I ask Diana to chime in 
> and present
> herself.
> 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.
> Well, IMO, volunteering for such a critical yet hard job is 
> enough of a
> statement for my vote, so I vote +1 to have Diana 'documentation
> coordinator' and grant commit access to her so that she can update the
> docs directly.
> Of course, we, as a dev community, must make all possible efforts to
> help her in those situations where she requires help.
> At the end, I'm overly pleased by proposing (finally!) a women in the
> Cocoon Development community.
> 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.
> Thanks.
> -- 
> Stefano Mazzocchi      One must still have chaos in oneself to be
>                           able to give birth to a dancing star.
> <>                             Friedrich Nietzsche
> --------------------------------------------------------------------
> ---------------------------------------------------------------------
> To unsubscribe, e-mail:
> For additional commands, email:

Information in this email and any attachments are confidential, and may
not be copied or used by anyone other than the addressee, nor disclosed
to any third party without our permission.  There is no intention to
create any legally binding contract or other commitment through the use
of this email.

Experian Limited (registration number 653331).  
Registered office: Talbot House, Talbot Street, Nottingham NG1 5HF

To unsubscribe, e-mail:
For additional commands, email:

View raw message