Jeff has effectively parried my first concern. Happy me! Thanks, Jeff.
We really need one good CR package example at least ...
Lars, I agree with your other comments. There's no need to include datamodel or API documentation in the documentation. Big picture stuff is all a competent hacker needs to speed up their understanding of the code they're looking at, and we shouldn't burden our developers with requirements to provide stuff already found in the code. I don't know if this is an XP thing or not, but I do know it's been true in much of the industry ever since I got sucked into it in 1971.