>The other thing about documentation is that it inevitably goes stale.

Not if you generate reference docs from code and how-to docs from tests.