Documentation updates

See #4534 and #9835.  Mostly this includes technical content changes and autogeneration fixes.

Definitely needs review from @hflynn - I think everything we've discussed previously has been covered now, but if not I can add more here.