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.
- Extenders (and perhaps maintainers) of ZODB need clear documentation of
the APIs, including dynamic aspects, which are not handled well by interfaces.
Obviously, you should be guided, at least in part, by existing non-executable
documentation.
Jim
--
Jim Fulton mailto:[EMAIL PROTECTED] Python Powered!
CTO (540) 361-1714 http://www.python.org
Zope Corporation http://www.zope.com http://www.zope.org
_______________________________________________
For more information about ZODB, see the ZODB Wiki:
http://www.zope.org/Wikis/ZODB/
ZODB-Dev mailing list - ZODB-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zodb-dev
