[ZDP] BackTalk to Document The Zope Book (2.5 Edition)/Using Basic Zope Objects

webmaster@zope.org webmaster@zope.org
Sat, 21 Sep 2002 18:43:16 -0400


A comment to the paragraph below was recently added via http://www.zope.org/Documentation/Books/ZopeBook/current/BasicObject.stx#3-36

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

      and click *Save*.  Now you can click on the *View* tab to view the
      page template.  This particular template does not do anything
      special or have any dynamic behavior.  In later sections in this
      chapter, we'll add some dynamic behavior.  In Chapter 5, you'll
      use page templates in much greater detail to create dynamic
      presentation.

        % Anonymous User - Apr. 23, 2002 3:17 am:
         Is it Test tab, instead of View tab?

        % Anonymous User - Apr. 25, 2002 6:20 pm:
         Looks like it is in fact the "Test" tab.

        % Anonymous User - Apr. 26, 2002 5:48 am:
         on a normal DTML document it's the view tab.

        % Anonymous User - May 6, 2002 4:13 pm:
         "... and click Save Changes..." instead "... and click Save..."

        % Anonymous User - July 23, 2002 10:52 pm:
         Ok. I dont get it. If there are errors found in the book, and they go into Chris's inbox, why isnt the
         documentation updated to reflect the corrections? What is the point of enabling comments if they arent used
         to improve the quality of the documentation? ...reading the comments shouldnt be required to find incorrect
         documentation.

        % mcdonc - July 25, 2002 9:57 am:
         They comments *definitely* improve the quality of the documentation. The revision cycles just isn't aren't as
         immediate as "get comment, change docs". Instead, the comments are addressed in the prose (and removed) in
         the next major editing cycle of the book. The editing cycle is meant to follow the cycle of Zope releases, so
         these are meant to happen every six months or so. In the meantime, questions by way of comments are addressed
         within comments themselves, so if you are confused about something, you should probably either comment or at
         least read existing comments.
         I have found the comments invaluable and when they are addressed in prose, they make the docs much, much
         better. FWIW, you can see a (temporary) "development" version of the Zope Book 2nd edition (meant to cover
         Zope 2.6) at http://saints.homeunix.com:8081/ZopeBook. - chris

        % mcdonc - Sep. 21, 2002 6:43 pm:
         The saints.homeunix.com address no longer exists. The new URL for the 2.6 edition is
         http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition