This is pretty nice... the current Zope help system does something
vaguely similar (at a less granular level) inasmuch as Product
developers can associate help pages with views or with arbitrary other
topics.   It might make sense for us to build a hook in the help system
whereby developers could easily register new homogenous help pages for
method definitions level by calling:

helpsystem.addMethodHelpTopic(productname, filename, classname,
methodname, description)

or something even simpler like:

helpsystem.addMethodHelpTopic(productname, methodobject)

...which introspected on the method object and "did the right thing".

This would be a pretty cool feature, IMHO.  I think we're at a stopping
point in the development of help system stuff, but I'd definitely add
this to the docs wiki at http://www.zope.org/Wikis/Docs/FrontPage if
you're interested in seeing something like this in there... or, of
course, you could start a small project on dev.zope.org to get it
going..

Kapil Thangavelu wrote:
> 
> I've been playing around with the ACS a bit lately. Its got one feature
> which i would desparately like to see in zope. namely that every ACS
> server is self documenting with regards to all of its methods. to see it
> in an action check out
> http://www.arsdigita.com/doc/procs
> 
> this documentation is generated on startup of the server for all
> available functions which make a call to a function proc_doc.
> 
> i looked at the existing python code auto documentors and the one i saw
> that looked the best was
> http://www.lfw.org/python (at the bottom of the page)
> for documenting live objects. it could use some modifiying to generate
> zope objects which would get cataloged and also to include a
> functions/modules source.
> 
> does anyone think that this would be a good resource to have in zope.
> searchable docs for developers on their servers of all the Zope Internal
> Python Code and the Code for all the installed Products?
> 
> Kapil
> 
> _______________________________________________
> Zope-Dev maillist  -  [EMAIL PROTECTED]
> http://lists.zope.org/mailman/listinfo/zope-dev
> **  No cross posts or HTML encoding!  **
> (Related lists -
>  http://lists.zope.org/mailman/listinfo/zope-announce
>  http://lists.zope.org/mailman/listinfo/zope )

_______________________________________________
Zope-Dev maillist  -  [EMAIL PROTECTED]
http://lists.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://lists.zope.org/mailman/listinfo/zope-announce
 http://lists.zope.org/mailman/listinfo/zope )

Reply via email to