document new api's, cleanup readme, bump version