I have written a fishbowl proposal outlining a project for writing API documentation for Zope: http://dev.zope.org/Wikis/DevSite/Proposals/APIReference Please review and leave your comments, I am very interested in hearing what you have to say about this. -Michel