API cleanup step 0

This is the first step toward cleaning up the API so that the supported surface area is more manageable and better documented.  I've added some items on the ROADMAP doc to describe a bit of what I have in mind, and all of this is very much up for discussion, of course.