[Zope] What causes the community to stall so often?

Andreas Jung andreas@andreas-jung.com
Fri, 8 Mar 2002 08:27:17 -0500


----- Original Message ----- 
From: "seb bacon" <seb@jamkit.com>
To: "Mitch Pirtle" <mitch.pirtle@kuehne-nagel.com>
Cc: <zope@zope.org>
Sent: Friday, March 08, 2002 08:07
Subject: [Zope] What causes the community to stall so often?


> 2) What is the secret to PHP's excellent documentation?

Comparing PHP with Zope is like comparing cats with cows.
PHP is a language with a well-documented API. PHP is a framework
with a more sophisticated and complex architecture. Documentating
a language, its syntax and its API is much more easier than
documentating a complete framework and the interaction of all
components. Maybe it is easier for book- and documentation writers
to document easy systems than complex ones.

Zope 3 with its component model will be more like PHP. Simple
components with a clear functionality and clear API are much better
to understand, to document and to use. Mixin-classes in Zope 2 are
often magic :-)

<sarcasm>
Maybe PHP developers need more documentation because Zope developers
are more clever? ;-)
</sarcasm> 

- aj