update translation documentation to outline best practices