docs(readme): improved documentation NO MERGE