日本語の文章
分かりやすい下書きを作り、言葉と構成を推敲する。 読み手、文体、形式、長さは依頼に合わせる。
意味
- 事実、数量、条件、例外、不確実さ、義務と推奨の違いを保つ。一部の観察を全体の話に広げない。
- 原因、出典、意見、体験を作らない。
- URL とコード、コマンド、識別子、パス、引用、製品名は、変更が依頼に含まれない限り、そのまま残す。
- 同じ意味には同じ語を使う。異なる概念を一つの語にまとめない。
下書き
- 読み手が必要とする要点から書く。一文に一つの主な内容、一段落に一つの話題を置く。
- 身近な語と素直な動詞を使う。専門語は、読み手に説明が必要なときだけ補足する。
- 主語と述語を対応させ、修飾語を係り先に近づける。長い修飾や二重否定は、意味を保って言い直す。
- 主体が分かる場合は明示する。システムの動作もそのまま書く。主語を埋めるために人を作らない。
- 手順は一文につき一つの操作にする。前提条件は、操作を始める前に分かる位置に置く。
- 敬体と常体は依頼や原文に合わせる。文末に変化をつけるために混ぜない。
推敲
- 内容を予告するだけの前置きや、中身のない強調を削る。例えば、「本質的な価値」「シームレスな体験」「特筆すべきは」。
- 抽象的な評価を、与えられた具体的な事実に戻す。残す事実がなければ、その評価を削る。
- 要点を直接書く。飾りの対比、問いかけ、結論の繰り返し、引用以外の不要な括弧やダッシュを削る。
- 判断に必要な比較、留保、礼儀は残す。人間らしさのために感情や伝聞を足さない。
- 見出しや箇条書きは、探しやすさや比較に役立つときに使う。項目を無理に 3 つにしたり、段落を同じ長さにそろえたりしない。
確認
提出前に、次を確認する。
- 原文と一文ずつ照合する。誰が何をするか、数量、時点や順序、例外、不確実さ、義務の強さ、技術的な表記が変わっていないかを見る。
- 「一部」「すべて」「場合に限り」などの範囲や制限が変わっていれば直す。近くにある事実同士の関係を勝手に補わない。
- 長い文、用語、同じ型の繰り返し、指定の文字数を確認する。本文の全角文字と半角英数字の間に半角スペースを入れる。
見つけた問題を直してから提出する。 推敲の依頼では、依頼やこのルールに合わない箇所だけを直す。 説明を求められなければ、完成した文章だけを返す。 レビューの依頼では、問題箇所、理由、修正案を返す。依頼がなければ全文を書き直さない。