[ZWeb] Zope.org feedback: Zope Documentation
R. David Murray
Mon, 15 Apr 2002 07:41:33 -0400 (EDT)
On Sun, 14 Apr 2002, alan runyan wrote:
> Turning to the ZOPE Book. Which you basically have to read an entire
> chapter. because there are no further units besides chapters. People want
> to find out about metal:block. for instance, how do they do that? read the
> entire PageTemplates chapter?
> I have always wanted to see a Zope version of:
> compare those layouts to: http://www.zope.org/Documentation/ZopeBook/
Back in the old days when I worked with IBM mainframes, each subsystem
came with at least two (thick) manuals: the User's Guide, and the
Reference. The User's Guide was for learning in a topical fashion
about how to do stuff with the subsystem. The Reference was for
getting a complete list of all the possible commands and their
detailed syntax and semantics.
The Zope Book is a User's Guide. The Help system is supposed to be
the Reference, but it is incomplete.
Of course, the Zope Book still needs subsections <grin>.