Skip to content

Commit 5cc87ab

Browse files
committed
Document translation polishing guidelines inspired by yomiyasu
1 parent 62a51a0 commit 5cc87ab

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,19 @@
2020
- 翻訳文自体に句点の後で改行を入れてください。長い文では読点の後でも改行し、意味のまとまりを読み取りやすくしてください。改行直後に不要なスペースを残さないでください。
2121
- reStructuredText のインラインマークアップやコード例の途中は改行せず、コードブロックのインデントや文末の「。 ::」など、構文上必要なまとまりは保持してください。
2222

23+
## 翻訳文の推敲
24+
25+
この節は [yomiyasu](https://github.com/nanaism/yomiyasu) の推敲方針を参考に、この翻訳プロジェクト向けにまとめたものです。スキルの実行は前提とせず、原文、用語集、利用者が指定した訳し方、および本ファイルの翻訳・記法の規則に従って適用してください。
26+
27+
- 誤訳を修正する文字列では、訳文全体の読みやすさも確認してください。自然で正確な表現は残し、文体や表記を揃えるだけの変更を他の文字列へ広げないでください。
28+
- 意味の確認は既存の日本語訳ではなく英語の原文を基準にしてください。条件、例外、否定、数量、比較対象、処理の順序を保ち、文を分割・結合するときも、それぞれがどの動作や対象に掛かるかを変えないでください。
29+
- 動作の説明、推奨、許可、義務、可能性、保証を区別してください。「する場合がある」を「する」にしたり、原文にない「必ず」を加えたりしないでください。
30+
- 「これ」「そのため」などの指示語や接続表現は、指す対象や前後の関係を確認してください。不明な動作主や理由を推測で補わず、前後の説明やコード例でも判断できなければレビュー資料に疑問点を記載してください。
31+
- 操作と結果の対応を明確にしてください。関数やオブジェクトを主語にした説明はそのまま自然に訳し、無理に人を主語に変えないでください。
32+
- 名詞を重ねた表現や回りくどい言い方は、助詞や動詞を使って関係を分かりやすくしてください。ただし専門用語は維持し、条件や対象を追うために必要な繰り返しまで省かないでください。文の長さや読点の数だけで機械的に書き換えないでください。
33+
- 推敲のために PO エントリーをまたいで情報を移したり、原文の見出し・段落・箇条書き・手順を省略したりしないでください。訳文の改行は「語順と読点」の規則に従い、RST の構造と識別子・参照・リテラルの記法を保持してください。
34+
- 推敲後は原文と再度照合し、意味の抜けや追加、条件の掛かり先の変化がないか確認してください。日本語の読みやすさの確認とは別に、既存の lint で記法も検証してください。
35+
2336
## レビュー資料
2437

2538
- レビュー用 Markdown をツールで生成した後、各変更の「状態:」行の直後に「修正理由:」として、その変更の理由を追記してください。再生成する場合も、理由を対応する変更の同じ位置に戻してください。

0 commit comments

Comments
 (0)