translate new doc. refs #497
apply review comments. refs #497
Merge pull request #746 from playframework-ja/issues_497

translate new doc. refs #497