概要

• Red Hat Style Guide の目的と基本方針を解説
• 文法・語法・句読点 の重要なガイドラインを要約
• アクティブボイス や 一致 などの具体的な用法例を提示
• 数えられる名詞 や 所有格 の正しい使い方を説明
• 文の構造 や 関係代名詞 の選択基準を整理

Red Hat Style Guideの目的

• Red Hat Style Guide は、著者が 明確かつ一貫性のある情報伝達 を行うための指針
• 多様な読者層 （エンドユーザーからエキスパートまで）を想定したドキュメント作成
• 正確性 と 一貫性 の確保
• 可読性 （Flesch-Kincaidスコア60-70）と 理解しやすさ （Gunning Fog index 9-12）の基準
• ユーザー中心 の情報提供、読者を見下さず、スキルを決めつけない配慮

可読性基準

• 技術文書は 対象読者にとって読みやすい ことが必須
• 最低でも中学2年生程度の読解力 を想定
• Flesch-Kincaid ・ Gunning Fog index で評価
• Gunning Fog index 9-12 を目標

文法ガイドライン

• The Chicago Manual of Style, 17th Edition を参照
• ここでは よくある文法事項 を重点解説

アクティブボイス（能動態）

• 能動態 を基本とし、例：「Type ... to start Linuxconf」
• 受動態 も状況により使用可（例：重要語句を前面に出す場合やリリースノート等）
• 能動態 は 簡潔 で 読みやすい 文書作成に有効
• 例：
  • 能動態 ：「Dutch hosting provider Oxilion launches public cloud service based on Red Hat Enterprise Virtualization.」
  • 受動態 ：「Public cloud service based on Red Hat Enterprise Virtualization launched by Dutch hosting provider Oxilion.」

一致（Agreement）

• 文法的一致 は 数・性 で発生
• 主語-動詞一致 は基本的知識
• 代名詞-先行詞一致 は注意が必要

代名詞-先行詞一致

• 単数名詞 には 単数代名詞、 複数名詞 には 複数代名詞
  • 例：「The CD spins in its caddy.」「The developers checked their work.」
• 集合名詞 は文脈により 単数/複数代名詞 を使い分け
  • 例：「Microsoft seems second to none in its marketing skills.」「The developers were asked for their preferences.」

数えられる名詞（Countable Nouns）

• 不可算名詞 には「less」「amount」
  • 例：「less memory」「the required amount of memory」
• 可算名詞 には「fewer」「number」
  • 例：「fewer opportunities」「exact number of words」
• 改善例 ：
  • 誤：「providing less opportunities」→ 正：「providing fewer opportunities」
  • 誤：「exact amount of words」→ 正：「exact number of words」

所有格（Possessives）

• 所有格 は「誰か/何かに属する」ことを示す
• 製品名や略語 には所有格を使わない
  • 誤：「Red Hat OpenShift's Logging operator」→ 正：「The Red Hat OpenShift Logging operator」
  • 誤：「NASA's documentation」→ 正：「NASA documentation」
• Red Hat 社名自体や人名・無生物には使用可
  • 例：「Red Hat's diversity, equity, and inclusion efforts」「Eddie Jaoude's YouTube channel」

関係代名詞の使い分け（Who, Whom, That, Which）

• who/whom ：人に対して使用
• that/which ：物や概念に対して使用
• who ：主語となる人
• whom ：主語以外の人
• which ：物に対する関係代名詞
• that ：物に対する制限用法
• 例：
  • 「The jewel case, which previously held the CD, was broken recently.」
  • 「The CD that I received for my birthday is defective.」
  • 「Edward C. Bailey, who wrote "Maximum RPM", ...」
  • 「The company that published "Maximum RPM" was ...」
  • 「Who ate all the cereal?」「To whom should I address the letter?」

文の構造（Sentence Structure）

• 一文一義 を基本とし、 40語以内 を推奨
• 情報過多な長文 は避ける
• 改善例 ：
  • 誤：一文に複数の情報を詰め込む
  • 正：短文で分割し、要点ごとに整理

論点転換時の新セクション例

句読点やその他の文法事項

• コロン・セミコロン・カンマ などの用法
• リスト内や表内での句読点 の使い方
• 特殊文字や記号 の名称・参照方法
• 省略形・略語・特別な記号 の正しい使い方
• 会社名・製品名・ブランド名 の表記ルール
• 非改行スペースやバージョン番号 の使い方
• 引用・参考文献の記載方法

---

このガイドを参照し、 一貫性・明瞭性・可読性 を常に意識した技術文書作成を心がけること。