translate the new doc. refs #525
apply the review comment. refs #525
Merge pull request #660 from garbagetown/issues_525

translate the new doc. refs #525