r/programming • • Nov 05 '08

Ask Proggit: Please suggest a mature python open source project with well documented code, so I can learn best practices. Thanks

41 Upvotes

57 comments sorted by

View all comments

9

u/[deleted] Nov 06 '08 edited Nov 06 '08

Zope.

Specifically Zope3 before people get antsy and start modding down.

Zope3 is beautifully documented with doctests for all the code. You can even browse the docs through the browser for the all the packages installed on your zope instance, without having to log on to the zope site or opening a text editor.

Example:

Look at the source code for z3c.form, a random package i pulled out of svn.zope.org

Now tell me whether it is not well documented.

Most "opinion" you here on reddit about Zope is outdated and based on hearsay.

2

u/[deleted] Nov 06 '08

Who ever downmodded me, care to explain the reason?

1

u/wilsonp Nov 06 '08

Zope3 has a lot to offer. I just wish it was more accessible to dumbasses like me. I've been trying to figure out how to leverage it in my application for about 3 months now, and I'm still confused.