1. Talk about specific issue vs generalising
2. Let us address the root cause vs bandage
3. ...

https://hackernoon.com/12-manager-readmes-from-silicon-valleys-top-tech-companies-26588a660afe