[Zope3-dev] Zope 3 needs a new documentation strategy

2007-07-17 Thread Luciano Ramalho
One of the first questions anyone needs answered when studying a new framework is Where is the canonical reference for the API?. Try googling for zope 3 api documentation... [1] Everyone coming to a new framework expects the API documentation for it to be highly visible in it's main web site,

[Zope3-dev] Re: Zope 3 needs a new documentation strategy

2007-07-17 Thread Ross Patterson
Luciano Ramalho [EMAIL PROTECTED] writes: One of the first questions anyone needs answered when studying a new framework is Where is the canonical reference for the API?. Try googling for zope 3 api documentation... [1] Everyone coming to a new framework expects the API documentation for

[Zope3-dev] RFC: zopeproject

2007-07-17 Thread Philipp von Weitershausen
For the past weeks I've been toying around with egg-based installs of Zope and flexible WSGI-based deployment using PasteDeploy [1]. Both essentially challenge the concept of instances as we know them. What is an instance? * Start/stop scripts for a pluggable application

Re: [Zope3-dev] Zope 3 needs a new documentation strategy

2007-07-17 Thread Paul Carduner
+1 The problem is that the people who know where to find all the information are too busy producing very successful Zope3 applications :). I mean, making the hard to find documentation more available could be considered helping the competition? At some point, someone (I believe Stephan