incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "robert burrell donkin" <robertburrelldon...@gmail.com>
Subject Re: [doc] Roles and Responsibilities Update Needed [WAS Re: Mentors - the more, the merrier?]
Date Sat, 15 Jul 2006 08:32:07 GMT
On 7/14/06, Cliff Schmidt <cliffschmidt@gmail.com> wrote:
>
> On 7/14/06, robert burrell donkin <robertburrelldonkin@gmail.com> wrote:
> > On 7/14/06, Noel J. Bergman <noel@devtech.com> wrote:
> > >
> > > Kenneth Tam wrote:
> > >
> > > >
> http://incubator.apache.org/incubation/Roles_and_Responsibilities.html
> > >
> > > > "A Mentor is a role undertaken by a permanent member of the Apache
> > > > Software Foundation and is chosen by the Sponsor to actively lead in
> > > > the discharge of their duties (listed above)."
> > >
> > > We still haven't fixed that doc?  Ok, rhetorical.  We need to fix that
> > > doc.
> >
> >
> > +1
> >
> > i'm still working on a couple of draft documents so i'm not sure i'll be
> > able to get this one before the middle of next week.
> >
> > anyone care to volunteer?
>
> Could someone point to the post that would explain how it should be fixed?


(focussing just on the document, not the content)

IMO policy should be maintained in only one document. the supporting
documentation should add descriptive and discursive content (unsuitable for
policy) and refer to the policy rather than repeat it. the policy document
should contain links to material in other documents that explain and discuss
the policy.

roles and responsibilities has a lot of overlap with the policy document and
has sections that repeat policy content. it lacks links to the actual
policy. i'd like to see definitions removed from the document and replaced
by links to the normative sections in policy document.

as for the actual policy, the policy document still contains the original
definition (members only) but IMHO this is a policy matter rather than a
documentation one.

- robert

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message