docs(readme): doc updated with corrections