clarified best practices guide and fixed typos