Thanks to all who responded to my query. I gained a lot of information from your responses. For the time being, I've opted to try the online 2.6 edition of The Zope Book. First off I want to say it's a privilege to have such documentation online. I appreciate the hard work that has gone into it. To be sure, it has so far been helpful and for this reason alone the authors, editors, and publisher deserve to have their final product bought and paid for when it is published. However...<noflames> :-) I printed it and spent half an hour reading and I find that it is lacking in some respects. It contains good content but the presentation is inconsistent. I had to read several sections multiple times to grasp easily explained concepts which could have been explained in one well-written paragraph or if presented in a different order. The layout itself became so distracting that to retain my sanity I had to start marking up the three chapters I read with layout revisions and suggestions. I suspect others new to Zope might have the same problems with it that I am having, so I must ask with whom (or where) I can correspond directly if suggestions are welcomed. Patrick Price Senior UNIX Systems Administrator West Virginia University Morgantown, West Virginia USA ============================= Couldn't a better name for "Script (Python)" been decided on? Scripted Python, Python Logic Objects, Embedded Python, Python-based scripts, PyScript, or *anything* but "Script (Python)"? It may be legal but it's *distracting*. :-) Andreas Jung wrote:

there is a new draft of the Zope Book covering 2.6 available on www.zope.org:

http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/

-aj

Hi, --On Dienstag, 20. August 2002 00:18 -0400 Chris McDonough <chrism@zope.com> wrote:

...

However...<noflames> :-) I printed it and spent half an hour reading and I find that it is lacking in some respects. It contains good content but the presentation is inconsistent. I had to read several sections multiple times to grasp easily explained concepts which could have been explained in one well-written paragraph or if presented in a different order. The layout itself became so distracting that to retain my sanity I had to start marking up the three chapters I read with layout revisions and suggestions.

Suggestions welcome! I haven't turned on the comment features of the book because it's not finished yet. Hmm. I should put that in the header, huh? ;-) <sound of patrick's dropping jaw goes here>. Sorry.... will do that now.

...

I suspect others new to Zope might have the same problems with it that I am having, so I must ask with whom (or where) I can correspond directly if suggestions are welcomed.

That would be me. It'd be nice for followups to stay on the list so we can have yet-another-how-much-the-Zope-docs-suck-and-in-the-end-everybody-scatters -when-faced-with-editing-duties sort of thread. Cynicism aside, I really am interested in specific advice on how to make it better, and I'll take any help. I'm not proud. ;-)

Ah, thats fine. Since I proofreaded the german translation of the book, I had to incorporate some small fixes regarding the newer Zope version and some stuff I came accross. For example the original book often uses "select * from table..." in ZSQL examples where I replaced it with "select column, column, ... from table" since this helps around mistakes and hard-to-find errors. Unfortunately the influence of the proofreader could only be minimal. Chris, if you want, I can send my suggestions to you. Regards Tino