improved TranslationMap docs cribbed from dueber