docs(readme): remove cruft and add clarifications