more documentation. fixed and enhanced translators