translate the new doc. refs #555
apply the review comment. refs #555
Merge pull request #669 from garbagetown/issues_555

translate the new doc. refs #555