Maintenance docs

This fixes some minor issues and also has a first stab for maintenance docs.

Comments are very welcome. I'm coming to the playdoh party late, so I don't know any of the prior history and it's entirely possible that everything I wrote here is a farce.

r?