----- 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