update readme.md to reflect best practices