I'm generally in favour, but one thing puzzled me: if some documentation (e.g. major design decisions and examples of API use) are required to be integrated before final acceptance, and are a good idea anyway, why not expect them to be integrated when the package is proposed?