On 7/14/06, Cliff Schmidt <[EMAIL PROTECTED]> wrote:
On 7/14/06, robert burrell donkin <[EMAIL PROTECTED]> wrote: > On 7/14/06, Noel J. Bergman <[EMAIL PROTECTED]> 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
