Hmm, To put in my two cents, I think perhaps there just needs to be more comprehensive in-points to documentation when seeking an answer. I would rather sit with a smoke and coffee in the morning reading some _well written docs by someone who makes a business of it, instead of crawling through lists and _hoping someone answers my usually idiotic question that is better dealt with other ways. When presented with the same site you just downloaded your first zope, I'm left with the impression; 'Um, whats next?'. Had this very email come to me from a gratuitous 'Thanks for downloading our product', much like 'for-sale' software is, I'd have at least 3 places to start looking. I sometimes get the 'ole-boys club' feeling where Unix is lore and since python makes most sense there (not that its less on windows, but come on, who would want to use that for slinging code?), there are more things 'You just have to know' than I am comfortable with. Mostly of what I say is true anyhow, but that can easily be remedied when you pre-empt that people arent going to understand you when you only explain the contraindications of the result instead of purpose and cause, and expected/intended behavoiur. All things aside, I feel Zope is misrepresented in this manner. Problems solved by answers is logical but don't always come immediatley, but the frustrations of not finding the path to the answers is your worst day at work. Its sorta like that proverb 'Teach a man to fish and he'll eat for a day.....'. Give us a good starting point and encourage people to use it. 2 cents from a total non-programmer who rocks zope. Paz -----Original Message----- From: zope-admin@zope.org [mailto:zope-admin@zope.org]On Behalf Of zbir@urbanape.com Sent: Wednesday, June 06, 2001 8:06 PM To: zope@zope.org Subject: Re: Zope docs (was Re: [Zope] I was wondfe)
Well some of the things that Owen Taylor says, are - unfortunately - true. Zope isn't well documented.
I wonder how long this meme will continue. We now have the Book, a prototype developer's guide, the help system (with an API guide), 312 howtos, and a cookbook (via ZopeLabs.com).
I think folks need to start becoming more specific when they say "Zope isn't well documented".
I think it's more along the lines of "Zope can't read my mind!" $name="zachery bir"; $email="zbir@urbanape.com"; $position="systems administrator"; $altposition="witch doctor"; $voice="804.353.3742"; $web="http://www.urbanape.com"; _______________________________________________ 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 )