[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