[Zope] The agony of the ZOPE Documentation

jiva@devware.com jiva@devware.com
Wed, 24 May 2000 11:59:54 -0700


I'm sorry, but I have to say, the ZOPE documentation, despite efforts
to improve it, is absolutely, positively horrible.  Not because the
content isn't there, but because the tools to access it simply suck.
I can type in searches on both zope.org and zdp.zope.org and though I
KNOW the information is there, I can't get the results I want!
Constantly, when I am recommending ZOPE to people, the ONE thing I and 
they complain about is the horrible documentation!

Is there some way that I can get a copy of all of the FAQ's, HOW-TOs,
Ref manuals, etc in some kind of raw ASCII text format or HTML or
something, so that I can build some kind of useful search engine for
this stuff?  The search engines on www.zope.org and zdp.zope.org just
plain suck.

Additionally, the zdp web site is a real nice idea that is SO poorly
executed IMO as to make it totally unusable.  You can't even browse
the documentation without clicking through a thousand different
links.  (I can give you specific examples of how to improve the site
if you want.)

Please, anyone?  Save Zope's documentation!

-- 
Some husbands are living proof that a woman can take a joke.