pass on creating the public api, move knowledge of what's public to one place
add documentation to public api
fix doc formatting
bump version # and changelog