Mailing-List: contact general-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: general@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of aidan.skinner@gmail.com
 designates 209.85.146.179 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:reply-to:sender:to:subject:in-reply-to
         :mime-version:content-type:content-transfer-encoding
         :content-disposition:references:x-google-sender-auth;
        b=u/ESdi8m2lj4MY3JetV7zaN5/4sIaNKzJ+CatUq8hUEJA4mkZJyHb2fiQrkHfj28E3
         fCGN//TryDIc3sbYInxlHZ7qXBoqTDhZM4iRUzkAwIxcl5Qx7cyxZ16f/Os6qReUO/t3
         ZmWU5M4vKZV1/N4HzCHkVd38nsRx+BImLjsTM=
Message-ID: <a4265f2a0808271014q76ecbe26w759cecc88f996307@mail.gmail.com>
Date: Wed, 27 Aug 2008 18:14:51 +0100
From: "Aidan Skinner" <aidan@apache.org>
Reply-To: aidan@apache.org
Sender: aidan.skinner@gmail.com
To: general@incubator.apache.org
Subject: Re: Add voting guide to incubator docs?
In-Reply-To: <4ED8A001-FED5-4A97-9DC4-568B7BFE5E48@SUN.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <918312fe0808240459l6ad597c2o3c213518950a406b@mail.gmail.com>
	 <4ED8A001-FED5-4A97-9DC4-568B7BFE5E48@SUN.com>

On Tue, Aug 26, 2008 at 7:03 PM, Craig L Russell <Craig.Russell@sun.com> wrote:

> Do you have any ideas on how to make sure that people read and understand
> the documentation, either the existing or proposed update?

I suspect it's an ordering issue (and conflation of the concept of PMC
and PPMC, rather than PMC and IPMC). The section on who's vote is
binding is buried relatively deeply in the last sentance of the 3rd
paragraph, immediately before the information you were probably
scanning the page for in the first place if you'd read the page before
and wanted a refresher.

I think a seperate "How to vote" that both the release page and the
PPMC page can reference would help clarify things. Might not help with
people who just don't read it in the first place, or read it and then
forget how it's suppoused to work but..

- Aidan
-- 
Apache Qpid - World Domination through Advanced Message Queueing
http://cwiki.apache.org/qpid
"Nine-tenths of wisdom consists in being wise in time." - Theodore Roosevelt

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