Hi, I'm going to (try!) to write a small book on Zope. I hear people complaining a lot about the documentation with Zope. I'm all ears to hear what persons expect from such a book. Right now, I'm generating the table of contents, thus it's a good time to include what people expect. After that I'll post this to the publisher. If the publisher agrees, then it's only waiting until the book is finished. You can send examples of what you need, ideas etc to my address tom.deprez@village.uunet.be and I'll try to incorporate them. Regards, Tom. ps. This is also good information for the ZDP.
Make sure you cater for novices. The Zope Content Management Guide is at about the right level, I think, but is hideously out of date :( I really like the idea of a step-by-step sample site though... After that you need to introduce DTML in all its gory detail :-) Like the DTML Guide but more of a guide than an out of date reference. (make you you include the tree tag in detail, it results in a lot of posts...) That'd probably cover a small book quite comfortably ;-) If you need more, then cover specific areas like SQL methods, ZClasses and the PTK. A whole other section would be for Zope administration (maybe even a seperate book!) including the simple things like installing and runing on Unix/NT along with things like hosting behind apache with proxypass, etc... If you had space you could chuck ZEO in here too.. My $0.08 Chris Tom Deprez wrote:
Hi,
I'm going to (try!) to write a small book on Zope. I hear people complaining a lot about the documentation with Zope. I'm all ears to hear what persons expect from such a book. Right now, I'm generating the table of contents, thus it's a good time to include what people expect. After that I'll post this to the publisher. If the publisher agrees, then it's only waiting until the book is finished.
You can send examples of what you need, ideas etc to my address tom.deprez@village.uunet.be and I'll try to incorporate them.
Regards, Tom.
ps. This is also good information for the ZDP.
_______________________________________________ Zope maillist - Zope@zope.org http://lists.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://lists.zope.org/mailman/listinfo/zope-announce http://lists.zope.org/mailman/listinfo/zope-dev )
I think it should be broken up into three parts: Basic Content in Zope, Expanding Zope with ZClasses, Expanding Zope with Products. The first would focus on using DTML, SQL Methods, and other existing Zope products. A user would only that section and make a nice web page. The second would focus on making your own Z Classes that are search catalog aware, data-bound, etc. The final chapter would assume python skills and show you how to make a full-blown Zope product. I would also dig a set of slick, practical examples at the end of each part, showing in a real-world way how to put what that part documents to good use. Tom Deprez wrote:
Hi,
I'm going to (try!) to write a small book on Zope. I hear people complaining a lot about the documentation with Zope. I'm all ears to hear what persons expect from such a book. Right now, I'm generating the table of contents, thus it's a good time to include what people expect. After that I'll post this to the publisher. If the publisher agrees, then it's only waiting until the book is finished.
You can send examples of what you need, ideas etc to my address tom.deprez@village.uunet.be and I'll try to incorporate them.
Regards, Tom.
ps. This is also good information for the ZDP.
_______________________________________________ Zope maillist - Zope@zope.org http://lists.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://lists.zope.org/mailman/listinfo/zope-announce http://lists.zope.org/mailman/listinfo/zope-dev )
-- Ken Kinder 303.381.7631
I would also dig a set of slick, practical examples at the end of each part, showing in a real-world way how to put what that part documents to good use.
I agree with this 100%...for Zope newbies, the "Learn *** in 21 Days" format would be great. Those books give users a sense of accomplishment, and have them doing great, cool things in just a couple days, so users are inspired to continue on. If you can make your readers feel empowered, instead of lost in a mess of documentation, you will hardly be able to keep your book off the shelves! :-) Jessica
participants (4)
-
Chris Withers -
jessica lee tishmack -
Ken Kinder -
Tom Deprez