updated 'best practices' documentation