That sounds like a good plan. Thanks for working on this.
However, I think that it would be preferable to get new docs out as soon
as possible, rather than waiting for even better docs. Once those
improvements are integrated, we could do another pydoctor release and
update Twisted's API docs without there being a new Twisted release.
Does this sound like a plan?