[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.