[tomster] WTFM

Let’s face it: Zope and Plone have a steep learning curve for new developers. Anybody remember when they were first confronted with a backtrace reaching up several dozen of layers all the way down to Module ZPublisher.Publish, line 119, in publish? In a word: left to your own devices, debugging a troublesome bit of your own code can be quite frustrating, if, say, all you’ve done is misspell a variable and all you get is 164(!) lines of backtrace bleeping TraversalError at you.

Well, the best kind of bugs are those that you don’t even produce in the first place, of course. Meaning that if a new developer has some ‘best practices’ to guide him, he or she can spend more time debugging the business logic of his or her application and less time banging his or her head against obscure implementation details of Zope 2, Zope 3, Archetypes, CMF, Five and uh… oh, yeah… Plone.

The problem is, though, that the collective wisdom of the community on how to deal with many of these issues isn’t really documented much. This is especially true for the new ‘bleeding edge’ technologies such as Zope 3 in general, Five and formlib. And who can really claim to know exactly what kind of many useful gems are hidden in the numerous z3 related repositiories (z3c, lovely, zc et. al.). For Zope 3 there’s of course the ‘new’ zope3-wiki that was created specifically to address the issue of lack of centralized documentation on zope 3, but I haven’t found it very helpful or accessible so far … however, mainly due to the fact, that it’s (of course) entirely Plone agnostic, so one of the difficult bits is to figure out, which of the information is even applicable.

This sprint is a wonderful opportunity to add some documentation to address some of the basics for Plone (Product) Developers, especially, since many of the authors of the aforementioned technologies are present at the sprint. We’re going to start with a how-to on using Viewlets … let’s see how that goes…


2 responses to “[tomster] WTFM

  1. Tomster,

    Great points…

    I thought you might want to know about some of the recent documentation work by the Plone doc team. Re plone 3.0 products, check out: http://plone.org/documentation/manual/upgrade-guide/version/2.5-3.0/products

    I think there is more for 3.0, but it is not public yet, as it is part of the push towards 3.0 documentation and the “DocCom” sprint coming up at end of June: http://plone.org/events/sprints/doc-ecommerce

  2. Good pointer, especially the upgrade guide (which, of course, is still a work in progress — but a good place to aggregate, nonetheless).

    Thanks Christopher,


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s