[Zope] The agony of the ZOPE Documentation

[Peter Marriott]

I too was struggling to stay sane while coding in DTML, until I came across
this little beauty from AlexR.

http://www.zope.org/Members/AlexR/ZopeDocs

He has combined Howto's and Tip's into PDF's, with nice contents pages and
you can easily search PDF's.

Hope this helps !

Peter Marriott




-----Original Message-----
From: zope-admin@zope.org [mailto:zope-admin@zope.org]On Behalf Of
jiva@devware.com
Sent: Thursday, 25 May 2000 3:00 AM
To: zope@zope.org
Subject: [Zope] The agony of the ZOPE Documentation


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.

_______________________________________________
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 )