Re: [Zope-dev] Reasons for the current API reference docs implementation?

Chris McDonough wrote at 2004-4-4 13:56 -0400:

... I think the "real" answer would be to go and create interfaces for all API classes and turn that into an API reference

*BEWARE* however, that interfaces lack information *VITAL* for an API reference: the constructor description! Look at the amount of questions in the mailing lists concerning object construction and you will understand that documentation of the constructors is necessary beside what is usually conveyed by an interface. -- Dieter