improvements to documentation and reverse translation