[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