commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Phil Steitz <phil.ste...@gmail.com>
Subject Re: [pool] Developers Guide
Date Tue, 26 Jun 2012 16:58:41 GMT
On 6/25/12 11:36 PM, Mark Thomas wrote:
> +1 - drop it.
>
> I'd rather put the effort into the Javadoc.
My thoughts exactly.  I will keep plugging away as I review the code.

Phil
>  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
>
>



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


Mime
View raw message