Can we require prose documentation too?  API documentation is sometimes sufficient for experts who are willing to put in the required effort, but prose with examples is much better at giving a high-level sense of how an API is meant to be used and what capabilities the library offers.  This is something I've been trying to push Twisted into as well, FWIW.