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

webmaster@zope.org webmaster@zope.org
Fri, 17 Jan 2003 08:43:22 -0500


A comment to the paragraph below was recently added via http://www.zope.org/Documentation/Books/ZopeBook/current/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 - Aug. 31, 2002 11:20 am:
     Do any of these classes inherit anything from anything else?
     Why is ZClass absent?

    % Anonymous User - Oct. 10, 2002 10:12 am:
     Since many of the API objects/methods have no examples elsewhere in
     The Zope Book, it would be helpful to have at least one example of
     each here. If there were a single chapter of the book containing an
     organized API tutorial for all of these, the reference could remain
     a reference with no examples!

    % Anonymous User - Jan. 17, 2003 8:43 am:
     Examples are needed. People who hate them should be able to disable them, just like comments. Everybody wins.