技術記事の書き方:複雑な概念をわかりやすく伝える表現、たとえの選び方と例の設計
技術記事とは論文をやさしい言葉に置き換えることではなく、同じ概念を読者の役割ごとに三つの層に分けることです。たとえは意思決定者に、例はエンジニアに、数式は実装者に。三つの層はそれぞれ独立して理解でき、互いに依存しません。直感に反する判断:基礎概念を細かく説明するほど初心者には好かれますが、専門家読者の離脱率は上がります。技術記事の信頼は「すでに知っていることを説明しない」ことから生まれ、「すべてを網羅する」ことからは生まれません。たとえは読者自身の業界から取る必要があり、領域をまたいだたとえは読者の30%を直接誤った方向に導きます。


