[Zope3-dev] interface implementation errors

[Gary Poster]

On Sat, 2002-11-16 at 15:19, R. David Murray wrote:
> On Tue, 12 Nov 2002, Martijn Faassen wrote:
> > Guido Wesdorp wrote:
> > [generate documentation from interfaces only]
> >
> > > Hmm... That would leave a gap in the (generated) documentation, stuff that is
> > > important to know about but not defined in the interfaces (e.g. additional
> > > 'public' methods on objects that use a general interface) will not be picked
> [...]
> > Wouldn't it be possible to create a derived interface for those particular
> > objects which documents those apparently important public methods? I
> 
> IMO, if methonds are important enough to be called externally (even
> in potential), they should have an Interface.  In which case any
> "gaps" should be viewed as bugs.

a strong and heartily-felt +1.

Gary