- Notifications
You must be signed in to change notification settings - Fork7
TranslationRules
TAKASE Arihiro edited this pageDec 8, 2015 ·2 revisions
これは rst ファイルを直接翻訳するときのルールです。Transifex を利用した翻訳は翻訳手順 を参照してください。
翻訳文の一行の長さは、75文字前後を目安にしてください。厳密になる必要はありません。長い段落の最初の方を修正したときに、折り返しの長さの調製のために段落の残りの部分を全部修正していくのは手間ですし、レビュー時に差分を確認するのも難しくなります。文中での改行位置は、できるだけ文節にしてください。
少なくとも Python 2系では、docstring の内容は翻訳しないでください。非ASCII文字列をバイト文字列リテラルで書くのは良くない習慣です。
コメントは、基本的に翻訳してもしなくてもかまいません。ただし、チュートリアルについては、意味のあるコメントは翻訳するべきです。