[ZDP] BackTalk to Document The Zope Book (2.6 Edition)/Appendix B: API Reference

[webmaster at zope.org]

A comment to the paragraph below was recently added via http://zope.org/Documentation/Books/ZopeBook/2_6Edition/AppendixB.stx#1-0

---------------

  This reference describes the interfaces to the most common set of
  basic Zope objects.  This reference is useful while writing DTML,
  Perl, and Python scripts that create and manipulate Zope objects.

    % Anonymous User - June 20, 2002 6:55 pm:
     This section needs a Table of Contents too.

    % Anonymous User - June 26, 2002 1:43 pm:
     The reference describes nearly nothing when you don't know the solution! 
     Examples are absolutely necessary.

    % Anonymous User - July 12, 2002 3:32 pm:
     i agree.

    % Anonymous User - July 14, 2002 5:21 am:
     Strongly disagree.  This is a reference, not a tutorial or explanatory text.

    % Anonymous User - Aug. 20, 2002 11:13 pm:
     A reference doesn't contain explanatory text?

    % Anonymous User - Nov. 12, 2003 10:52 am:
     Look at http://www.php.net : it's both a precise API reference for PHP developers, and a tutorial full of
     interesting samples.
     Apart from the Zope Book (which efficiently sums up the ZMI) I have rarely seen such a poor pedagogical and
     practical approach as among the zope documentation.