タグ: #design-doc

← すべての記事

• エンジニアの書く力 — 設計文書・障害報告・レビューコメントの仕事

  エンジニアに文章力が大事だという話はよく聞きますが、なぜ大事なのかはたいてい昇進の話で終わります。この記事は順序を変えて見ます。文章はまず自分の思考を検証する装置であり、組織の中で反論できる面を作る道具であり、その結果として評価に影響します。設計文書で最も重要なのがなぜ捨てた案なのか、障害報告で事実と解釈を分けることがなぜ政治ではなく技術なのか、レビューコメントに等級を付けるとなぜ衝突が減るのかを扱います。高いまま残る技術シリーズの第5

  2026-08-15 · 13 分で読めます #career#skills#technical-writing#design-doc#postmortem

• 設計ドキュメント完全ガイド: 決定を残す文書と消える文書

  設計ドキュメントを文章術ではなくチームの意思決定インフラとして扱います。1-pager・設計ドキュメント・ADR・RFC のどれをいつ使うか、レビューをどう運用するか、決定がどう期限切れになるか、そして文書が失敗する八つの形を整理します。

  2026-08-15 · 41 分で読めます #설계문서#adr#rfc#design-doc#기술문서

• 文章で説得する — 設計文書とRFCが通る構造

  設計文書、RFC、提案書、障害後のフォローアップ勧告を書く人のための記事です。自分が問題を解いた順序ではなく、求める決定を一番前に置く方法、却下した代替案を示すことがなぜ提案書と広告を分ける唯一の目印なのか、何もしなかったときのコストをどう数字にするか、流し読みする決定者にどう向き合うかを整理しました。そして最も重要なこと、自分がいない会議で引用される段落をどう書くかを扱います。弱い提案の段落を一つ実際に書き直し、文書で実際に効く手を表

  2026-08-02 · 27 分で読めます #career#writing#persuasion#design-doc#engineering

• 開発者ライティング完全ガイド: Design Doc、RFC、ブログ、書籍、カンファレンス発表まで (2025)

  Staff+ エンジニアの影響力の80%は、コードではなく文章から生まれる。GoogleのDesign Docテンプレート、Rust/Python/NodeのRFCプロセス、Julia Evans/Dan Luu/Stratecheryのブログ分析、O'Reilly/Manning出版プロセス、カンファレンスのCFPから本番発表までの実践。AI時代のライティングツール活用、韓国語 vs 英語ブログ戦略、Staff+ 昇進パケットの書き方

  2026-04-15 · 24 分で読めます #writing#design-doc#rfc#tech-blog#conference-talk

• 技術文書英語ライティングガイド: RFC·ADR·Design Doc·Tech Specテンプレートと実践表現

  ソフトウェアエンジニアのための技術文書英語ライティングガイドです。RFC、ADR、Design Doc、Tech Specの構造とテンプレートを比較し、各セクション別の主要英語表現（Problem Statement、Proposed Solution、Alternatives Considered、Trade-offs、Success Metrics）とレビューフィードバック表現、非ネイティブスピーカーの典型的なミスまで実践的にまとめ

  2026-03-12 · 29 分で読めます #english#technical-writing#rfc#adr#design-doc

• 英語技術文書作成完全ガイド：RFC・ADR・Design Docパターンと実践表現

  RFC・ADR・Design Docパターンと実践表現を網羅した英語技術文書作成の完全ガイド。

  2026-03-10 · 27 分で読めます #english#technical-writing#rfc#adr#design-doc

• 英語テクニカルライティング実践ガイド：RFC、ADR、Design Docの書き方とテンプレート ♪ 聞けます

  エンジニアのための英語技術文書作成法。RFC・ADR・Design Docの構造と目的、効果的な英語表現、実践テンプレートとレビュープロセス、グローバルチーム協業コミュニケーション戦略まで。

  2026-03-06 · 37 分で読めます #english#technical-writing#rfc#adr#design-doc