incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John D. Ament" <johndam...@apache.org>
Subject Re: [DISCUSS] Drop the 2013 Alternate Voting Policy
Date Sat, 31 Dec 2016 14:03:28 GMT
On Sat, Dec 31, 2016 at 12:02 AM Marvin Humphrey <marvin@rectangular.com>
wrote:

> On Thu, Dec 29, 2016 at 11:46 AM, John D. Ament <johndament@apache.org>
> wrote:
> > Pssst really need you guys looking at the proposed replacement
> > documentation.
> >
>
> https://lists.apache.org/thread.html/fab8122d7695e47bacbff680b83eb4ceed98539a7815e2232abf5d2f@%3Cgeneral.incubator.apache.org%3E
>
> There's a lot here, and with social obligations of the holiday season,
> I'm having trouble finding the time to review it all. If I may suggest
> an approach, though:
>

So far, the input received has gone well. I think we're good with the first
step, updating release documentation to remove the duplication.


>
> For guides, how-to's and the like, it is nice if you summarize changes
> in advance, but we also shouldn't let anything block your way.  The
> Incubator has suffered from a lack of people willing to wade in and
> actually work on documentation -- having you show up to do work is a
> real boon. So if you tell people "I'm going to work on X, and here's
> roughly what I plan", then JFDI so long as you work incrementally and
> reversibly.  People have the option to review your commits.
>
> But for *policy*, specifically the Incubation_Policy.html page, please
> take a different tack.  Any change to that page should be proposed as
> a patch on general@incubator in a thread with a 72 hour minimum review
> period.  Furthermore, please try to make good use of our limited
> capacity for review: endeavor to make clean and minimal proposals,
> avoiding multiple revisions and large, hard-to-digest changesets.
>
> It's important to get the fine details of policy right because even
> minor wording inaccuracies can spawn brutal, bitter disputes.
> Additionally, a deliberate, inclusive drafting and review process is a
> prerequisite for community buy-in, inoculating us against crises of
> legitimacy.
>
> Does that division make sense?  Careful drafting and RTC for policy,
> CTR and a higher tolerance for inaccuracy in guides, FAQs, etc.
>
> One more thing: the Proposal Guide is way more important than all the
> others, so please treat it with care if you do any work there. During
> the crafting of a proposal for incubation, that page has profound
> influence on incoming communities as they think deeply about how their
> project might fit into Apache. (In fact, maybe we should make that
> page RTC...)
>

May be we should consider calling it the Proposal Policy?  I agree with you
on its importance.


>
> Marvin Humphrey
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

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