Paul Winkler wrote:
I'm not
sure that exposing the docstrings of the classes themselves would be
much better than the current situation,

well, it would arguably make it marginally more likely that the api reference is updated when the code is updated.

Indeed. I think using interfaces and docstrings would be good, as twisted does:

Who knows, it might even result in some docstrings getting updated :-)

At worst, it'll mean that people don't have to update 3 sets of (what should be) identical documentation, as is currently the case...



Simplistix - Content Management, Zope & Python Consulting

Zope-Dev maillist - [EMAIL PROTECTED]
** No cross posts or HTML encoding! **
(Related lists - )

Reply via email to