On Dec 20, 2005, at 10:36 AM, Paul Winkler wrote:
- HelpSys - from a programmers view pretty much useless and not very
helpful. I consider to replace it with something more useful
(not sure
we can re-use apidoc from Zope 3 in some way, perhaps the inclusion
of Dieter's Docfinder might be more useful for programmers)
-0
Whenever this topic comes up, people speak of HelpSys as if it's
all API
documentation for programmers. In fact the lion's share of it is
user-oriented online structured text documentation which is IMNSHO
very
good to have. And many third-party products provide such
documentation
of their own. Especially when I was new to Zope, I read them
constantly.
In Zope 2.10 , Products packaged as Python Eggs will need either to
drop support for helpsys stuff or the helpsys stuff will need to be
revamped support files living in zipfiles. The former sounds saner
to me and indeed Basket punts on registering help files for all egg-
packaged products right now. I agree it would be helpful to have the
info that's currently in the helpsystem for builtin Zope products be
available somewhere else, though.
- C
_______________________________________________
Zope-Dev maillist - Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
** No cross posts or HTML encoding! **
(Related lists -
http://mail.zope.org/mailman/listinfo/zope-announce
http://mail.zope.org/mailman/listinfo/zope )
