Upgrade to Pro — share decks privately, control downloads, hide ads and more …

技術書から学ぶ、 読みやすい文章の極意 / The Art of Clear Writing:...

技術書から学ぶ、 読みやすい文章の極意 / The Art of Clear Writing: Lessons from Technical Books

Avatar for Kento Kimura

Kento Kimura PRO

April 22, 2025

More Decks by Kento Kimura

Other Decks in Technology

Transcript

  1. わたしは… • 所属: Technical Solutions / Sales Engineer • 担当:

    パブリッククラウドのアーキテクト知識を活かした   Datadog のプリセールス技術支援 • 表彰: Google Cloud Partner Top Engineer 2023-25 Jagu'e'r Award 2023, 2024 優秀賞 2022-24 Japan AWS All Certifications Engineer AWS Community Builder(Cloud Operations, since 2024) • 好きな Google Cloud サービス: Cloud Run, Cloud Observability 木村 健人 (Kento Kimura) Datadog Japan GK History データセンター管理運用→パブリッククラウド技術支援 →プリセールス技術支援 Partner Top Engineer 2023 Partner Top Engineer 2024 Partner Top Engineer 2025
  2. 7 この技術書がすごい 『GitHub CI/CD 実践ガイド』 @tmknom • GitHub Actions から

    CI/CD の基本を学べる • 優れた網羅性と、学習しやすい流れの章立て • 最高の読書体験を目指した著者の執筆ルール • 文章の背景となる、他の名著への言及と引用
  3. 8 この技術書がすごい 『GitHub CI/CD 実践ガイド』 @tmknom • GitHub Actions から

    CI/CD の基本を学べる • 優れた網羅性と、学習しやすい流れの章立て • 最高の読書体験を目指した著者の執筆ルール • 文章の背景となる、他の名著への言及と引用 過去に『読みやすい技術書を書く技術』を執筆 ◦ 「出ない神本より出るクソ本」と言う名言を残す😂 ◦ 完璧を目指さず、書き終えることを最初の目標にする ◦ その上で、必要な校正ツールを活用する
  4. 20 まとめ • 兎にも角にも「書き切ること」が重要 • 読者を想定する ◦ どうしたら「読みやすい」か ◦ どうしたら「理解しやすい」か

    ◦ どうしたら「見やすい」か • ツールの力を活用する ◦ LLM に書かせるのではなく、直させる ◦ 最低限の校正ツールは手間 < 有用