[ZODB-Dev] We need to pay down debt

[Dieter Maurer]

Jim Fulton wrote at 2006-10-5 08:50 -0400:
>Russ Ferriday wrote:
>> I'll provide some time for this, Jim.
>> I'm no expert on the ZODB, which might be spun as an advantage, and I'm 
>> prepared to play a supporting role cleaning up doctests, or helping with 
>> doc organization. This means I don't mind gathering spippets from those 
>> who have them and pulling them together.
>
>Awesome.  Perhaps you can start thinking about how to organize the doctests.
>
>I think that there are 2 (or 3) main audiences to consider:
>
>- Users of ZODB
>
>   These folks need guidance on how to use ZODB to develop applications,
>   including pitfalls.

I do not think that doctests are the optimal means for those target group.
A guide, such as Andrew's guide, seems more appropriate in my view.



-- 
Dieter