I think that your redevelopment of API documentation would be an interesting series of blog articles in and of themselves. Giving examples of bad documentation

I think that your redevelopment of API documentation would be an interesting series of blog articles in and of themselves. Giving examples of bad documentation decisions, giving examples of how they were corrected in the new documentation, etc. There are lots of examples of refactoring code, but entirely too few that deal with refactoring the manual.