Add best practices documentation and update other docs

Add best practices documentation and update other docs #4505