I can't tell you--although some of you will know--what a delight it is to
be working on a project with an actual documentation engineer.
That person (Jonathan Sick, if any of you want to hire him) has engineered
things such that it is easy to write good documentation for the projects we
write, and not very onerous.
He's put in an enormous amount of effort to ensure that if we write
reasonably clean code, we can also auto-generate accurate and complete API
documentation for it. And to the degree we want to write explanatory docs,
that's catered for too.
It has been an amazing experience compared to my entire prior history.
Adam