Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Received-SPF: neutral (athena.apache.org: local policy)
References: <4FE9357B.5040601@gmail.com>
 <CACZkXPxZ+7K1vk-DN3mHOCUNOojK7y00JvDLokJVpjYpwTLAUQ@mail.gmail.com>
User-Agent: K-9 Mail for Android
In-Reply-To: 
 <CACZkXPxZ+7K1vk-DN3mHOCUNOojK7y00JvDLokJVpjYpwTLAUQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain;
 charset=UTF-8
Content-Transfer-Encoding: 8bit
Subject: Re: [pool] Developers Guide
From: Mark Thomas <markt@apache.org>
Date: Tue, 26 Jun 2012 07:36:12 +0100
To: Commons Developers List <dev@commons.apache.org>
Message-ID: <3d2b8b58-b254-49ed-ba6f-10275417267d@email.android.com>

+1 - drop it.

I'd rather put the effort into the Javadoc. That is where my focus was when working on the updates for pool 2.0.

I'd add that one of the things that drove me mad with pool 2 was that the same information was repeated in multiple places and trying to keep them in sync is really hard work. I'm a big fan of write once, reference everywhere. For me the Javadoc should be the primary source of information.

Mark

Gary Gregory <garydgregory@gmail.com> wrote:

>Drop it!
>
>Gary
>
>On Tue, Jun 26, 2012 at 12:07 AM, Phil Steitz <phil.steitz@gmail.com>
>wrote:
>
>> There is not much in this doc beyond class diagrams that are now out
>> of date.  Unless someone wants to volunteer to update the diagrams
>> and maybe add some more meaningful content, I propose that we drop
>> this for 2.0.  We can always add it back later if someone gets
>> inspired.  Personally, I would see more value in a config guide,
>> similar to what DBCP has.
>>
>> Any objections to dropping for 2.0, or volunteers to patch?
>>
>> Phil
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
>-- 
>E-Mail: garydgregory@gmail.com | ggregory@apache.org
>JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
>Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
>Blog: http://garygregory.wordpress.com
>Home: http://garygregory.com/
>Tweet! http://twitter.com/GaryGregory


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