Locate interface documentation via zope.interface.moduleProvides

[Richard Wall]

In https://twistedmatrix.com/trac/ticket/4685?replyto=16#comment:12 we have a series of module global functions which provide the twisted.internet.interfaces.IResolver interface.

We currently insert @see: L{twisted.internet.interfaces.IResolver.lookupAddress} so that we see links to the interface docs in the pydoctor api docs.

It would be nicer if pydoctor could find and insert the interface documentation - just like it does when it encounters an @implementer decorator.

See:
 * https://twistedmatrix.com/trac/changeset/37229/branches/IResolver-docs-4685

[Michael Hudson-Doyle (mwhudson)]

Makes sense. Not sure when I'm likely to get to it tbh.

[Richard Wall (richardw)]

I've submitted a branch for code review.

Also linked this ticket to https://bugs.launchpad.net/twisted-buildbot-configuration as a reminder to upgrade the Twisted buildbot when this issue is fixed.

As discussed in https://bugs.launchpad.net/twisted-website/+bug/1140776