Great work. I wish you could fix the HTML documentation packaging, though. I remember a while back when you could still get the DTML Guide as a single, flat HTML file (plus the images). The formatting stunk then, but at least you could easily browse the documentation. The formatting of the DTML and SQL guides remains pretty ghastly. In future releases, please include the option of viewing/downloading a single, flat HTML file, preferably with numbered sections (eg., "6.1. Iterative Insertion"). The table of contents produced by Frame Maker is so bad I'm surprised you haven't fixed it by hand. For example, in the case of the ZAG it starts of confidently, until "ZServer Command Line Switches", where it falls apart, adding paragraphs between each entry and forgetting to add a bullet. And when it's doen with all that, it says "Figure 1. CGI Overview" in huge letters and then starts off on a new table contents, nicely ordered but with the exact same contents. This is also the first table of contents on the web I've seen that includes page numbers. -- Alexander Staubo http://www.mop.no/~alex/ "`Ford, you're turning into a penguin. Stop it.'" --Douglas Adams, _The Hitchhiker's Guide to the Galaxy_
-----Original Message----- From: Pam Crosby [mailto:pam@digicool.com] Sent: 1. oktober 1999 23:42 To: 'zope@zope.org'; 'ZDP@zope.org' Subject: [Zope] ANNOUNCE: Documentation Release
Digital Creations is proud to announce the availability of several updated Zope Documentation guides.
* The much awaited Z Class Tutorial is now the first chapter of the Zope Developer's Guide. http://www.zope.org/Documentation/Developer/ More chapters will be forth coming!
* The Zope Administrator's Guide http://www.zope.org/Documentation/Guides/ZAG_doc , in draft mode, is also online. This guide covers Zope's installation and maintenance issues.
* The original guides are undergoing a metamorphous as we provide a more comprehensive Zope documentation effort. The Zope Content Manager's Guide, DTML Reference and ZSQL Guide have been modified to reflect the newest Zope 2 version. The new DTML syntax is incorporated into these guides. Similar reference guides and tutorials will follow. These guides are located on the main documentation page. http://www.zope.org/Documentation
Pamela Crosby
Technical Writer mailto:pam@digicool.com Digital Creations http://www.digicool.com
_______________________________________________ Zope maillist - Zope@zope.org http://www.zope.org/mailman/listinfo/zope
(Related lists - please, no cross posts or HTML encoding!
To receive general Zope announcements, see: http://www.zope.org/mailman/listinfo/zope-announce
For developer-specific issues, zope-dev@zope.org - http://www.zope.org/mailman/listinfo/zope-dev )