Cleanup for 1.0

I'm working through a list of small cleanup items so we can sign off a 1.0 version.  It's mostly organization, documentation and examples.  See the individual commits for more detail.