最高のテックブログを書くために気をつけている3つのこと | 株式会社ヌーラボ(Nulab inc.)

こんにちは。ヌーラボのCacooチームの木村です。テックブログを書く上で個人的に気をつけていることを紹介します。 「せっかく苦労して記事を書いたのに全然読んでもらえない」「本筋とは関係ないコメントが来て消耗してしまう」といった悩みはないでしょうか。それらはもしかしたら技術記事の書き方に原因があるかもしれません。 僕は普段進めている仕事に、ある程度の成果が出たら、そこで得た知見を会社のテックブログに記事としてまとめるようにしています。そのときには以下の3つのことを心がけています。 「なぜ」を徹底的に書く 読者の認知負荷を下げる 想定読者の知識レベル下げる そうすることで以下のような効果が期待でき、読者と著者だけでなく著者が所属する会社にとってもいい記事になると考えられます。 記事の内容が正確に読者に伝わる 読者にとって有益な情報を提供できる 著者（たち）の置かれている状況や抱えている課題が読

[tmatsuu]

わいわい。いいぞいいぞ

[tockri]

読者は記事のすべてを読んでくれない。ときにはタイトルすら読んでくれない。

[iselegant]

内容良かった。「"なぜ"は前提を共有し、妥当性を担保し、共感を生む」というフレーズが好き。

[sasasin_net]

これは最高のテックブログ記事ですねwww 好きwww

[tpircs]

読んでくれないことを前提にするのはとても大事だと思う。きちんと読んでもらえることを前提にしてる文章って結構読みづらい。

[kwbtsts]

控えめに言ってめっちゃええこと書いてあります