readme and api tweaks