[ZDP] BackTalk to Document The Zope Book (2.5 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/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.

    % Anonymous User - Jan. 22, 2003 4:57 pm:
     hi

    % Anonymous User - Aug. 6, 2003 10:47 am:
     Theese are python classes described below, but I could not find any reference, how they are used from python
     scripts. Which objects have theese methods? What are the relations of Zope classes and standard Zope API
     objects? Also examples would answere most questions, but the best thing would be some text about basic theory
     of theese things, maybe in a separate section!
     For example: How can I use the AuthenticatedUser.has_role() in a script? I would expect to find this in the
     Zope book.

    % Anonymous User - Aug. 7, 2003 7:02 am:
     How the hell do i use any of these things in python scripts?