Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cocoon-dev@xml.apache.org
From: "Carsten Ziegeler" <cziegeler@s-und-n.de>
To: <cocoon-dev@xml.apache.org>
Subject: RE: [vote] Diana Shannon as Documentation Coordinator
Date: Wed, 17 Apr 2002 08:45:13 +0200
Message-ID: <GMEBIBHGAOFGJCDPJANDGELPEBAA.cziegeler@s-und-n.de>
MIME-Version: 1.0
Importance: Normal
In-Reply-To: <3CBC17B2.919B723@apache.org>
Content-Transfer-Encoding: 7bit
Content-Type: text/plain;
	charset="us-ascii"

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 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.
> 
> 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
> 
>  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.
> <stefano@apache.org>                             Friedrich Nietzsche
> --------------------------------------------------------------------
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> For additional commands, email: cocoon-dev-help@xml.apache.org
> 

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