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

Stephan Richter stephan.richter at tufts.edu
Mon Apr 5 06:52:07 EDT 2004


On Monday 05 April 2004 03:49, Dieter Maurer wrote:
> 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!

It is totally legal to add the constructor to the interface. We do this in 
Zope 3 at some places too, like for adapters and views.

Regards,
Stephan
-- 
Stephan Richter
CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student)
Web2k - Web Software Design, Development and Training



More information about the Zope-Dev mailing list