updated best practices
Merge pull request #143 from ctetreault/master

updated 'best practices' documentation