はじめに
この記事は、Qiitaのコントリビューションランキング総合1位である伊藤淳一さんが執筆された、『技術記事を書く技術』を読んだ感想を記したものです。
この記事の読者として以下のような方々を想定しています。
- この本に興味がある人
- QiitaやZenn、ブログで記事を書いてみたいと思っている人
- アウトプットしたいけれど、不安があって踏み出せない人
- すでにアウトプットしていて、もう一段レベルを上げたい人
最初に大事な点を。
実はこの本、著者の伊藤さんから頂く機会を賜りました。なので、その上の書評なら「貰ったから忖度しているのでは?」と思われるかもしれません。そのため先に宣言しておくと、私は電子版を実費で買い直しました。それくらい手元に置いておきたい一冊だと感じたからです。
その理由を以下に書いていきます。
なお、めちゃくちゃ良い本だったという結論は先に述べておきます。
読了後の第一印象は「背中をそっと押してくれる本」
この本を一言で表すなら、「アウトプットしたいエンジニアの背中をそっと押してくれる本」です。
読んでいる最中の個人的なイメージは、以下のイラストのような感じでした(雑な絵ですみません)。
まるでジョジョのスタンドのように私の後ろに伊藤さんが立って、「もっと気軽に技術をアウトプットしてもええんやで。その気持ちが世の中のエンジニアを助けることになるんやで」と励ましてくれているような感覚になりました
(関西弁なのは作者が関西人だからで、これは勝手なイメージです)。
「Qiitaに記事を書いてみようかな、でも炎上したら嫌やな・・・」 そんな心境のエンジニアの内側を、菩薩の笑顔で見透かしたかのように、伊藤さんが「わかるで、その気持ち。俺もそうやった。でも、実際にアウトプットしたら色んな良いことがあるから、意外とやってみたら良かったってなるかもしれんで?」と応援してくれる。そんな読書体験でした。
何より、Qiitaで貢献度1位の伊藤さんがそう言っているので、実際に説得力しかありません(笑)
技術記事を書くコツが惜しみなく詰まっている
もちろん、本書は気持ちの後押しだけにとどまらず、実践的なノウハウもしっかり詰まっています。具体的には次のようなテーマです。
- どんな記事を書けばよいのか
- 読者にとって読みやすい記事の書き方
- 書いた記事に興味を持ってもらうための工夫
- 炎上したり、マサカリが飛んできたりするのを避けるにはどんな工夫ができるのか
- 一度きりで終わらず、書き続けるためのコツ
- その他、ノウハウ多数・・・
これらが、伊藤さんご自身の長年の経験に裏打ちされた言葉で、惜しみなく語られています。
読んでいて「なるほどなぁ!」と驚くところもあれば、「あ、これはわかる気がする」と共感できるところもあり、終始すっと頭に入ってくる文章でした。考えてみればこれ自体が、本書のテーマである『技術記事を書く技術』が体現された結果なのだと、読み終えてから気づきました。
教本としても、辞書としても使える
本書のもう一つの魅力は、一度読んで終わりではなく、後から何度も参照したくなる構成になっていることです。
たとえば自分がQiitaやZenn、ブログで記事を書いていて、「この部分の書き方、どう工夫すればいいかな・・・」と悩んだとき。本書を開けば、「そういえば伊藤さんはこう書いていたな、参考にしよう」と気づけます。教本としてだけでなく、辞書のように繰り返し引ける一冊になっています。
私自身もこれまでQiitaで記事を書いてきましたし、これからも書いていく予定ですが、その際にはきっとこの本を傍らに置きながら執筆することになるのではと思います。
巻末の「記事添削例」が圧倒的に実践的
私がもっとも実践的だと感じたのは、最終章にある記事添削の章です。Qiitaに実在する記事を伊藤さんが取り上げ、「ここはこう工夫すれば、もっと良くなる」と添削していく構成になっています。
これを読んだとき、私は過去の自分のQiita記事を見返しながら、「なるほど、ここはもう少し工夫できそうだ」と、自分の記事を具体的にどう改善すれば良いかのイメージが湧きました。
ひと口に技術記事といっても、視点や工夫の仕方は実に様々です。それらが一つひとつ、自分の中にインストールされていく、そんな感覚を味わえる章でした。
さいごに
冒頭でも書いたとおり、本書はアウトプットにチャレンジしたい人、すでにチャレンジしている人の双方に向けて、様々な角度からアドバイスを与えてくれる本です。
加えて本書には、単なる「書き方の技術書」にはない温かみがあります。「アウトプットしたい」というエンジニアの気持ちを、そっと後押ししてくれる温かみです。
普段Qiitaを読むだけで書いたことがない人、書きたいけれど何を書けばいいか迷っている人、すでに書いているけれどもっとレベルを上げたい人。・・・どんな段階のエンジニアにも刺さる一冊だと思います。
頂いた本を実費で買い直した、と冒頭で書きました。
理由はシンプルで、これから記事を書くたびに、何度でも開きたい本だったからです。本を持ち歩いていなくても、電子版ならいつでもアクセスできるので買おうと思いました。
同じ気持ちになる人が、きっとみなさんの中にもいるのではないかなと思っています。