[Product-Developers] Where does it hurt?

Jon Baldivieso jonb at onenw.org
Tue May 20 17:22:43 UTC 2008


On May 18, 2008, at 4:05 AM, Martin Aspeli wrote:

> - Areas where there's insufficient/poor documentation, but once you  
> learn how to do something, it's clear how to proceed.
>
> - Areas where there appears to be more than one approach, and it's  
> not clear which one to choose

A common source of frustration over the last two versions, as  
evidenced in this thread, has been the slow shift as we move from Zope  
2 ways of doing things to Zope 3.  It's not always clear when/how a  
technology has changed, and when you're developing for different  
versions of Plone, it can be confusing remember where you are.   
Perhaps a useful piece of documentation would be a single page  
(forgive me if this already exists -- I couldn't find it) that, by  
Plone version, lists the areas of technologies that have shifted,  
linking to the relevant documentation for them.  For instance (pardon  
the formatting and arbitrary examples):

Plone Version	|	Before we used	|	Now we use
Plone 2.5		|	Portlet logic within skinned portlet templates	|	Portlet  
logic delegated to views
Plone 3.0		|	Reusable chunks of HTML contained in macros in skinned  
template	|	Now in viewlets
Plone 3.0		|	Portal status messages passed through in query string	|  
Status messages registered through utility


Jon
___________________________
Jon Baldivieso
503.222.5064
ONE/Northwest Portland Office

New tools and strategies for engaging people in protecting the  
environment

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.plone.org/pipermail/plone-product-developers/attachments/20080520/54ffc27b/attachment-0001.html>


More information about the Product-Developers mailing list