Update docs with tips and best practices. Fixes #12 and #9