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