はじめに
伊藤淳一さん著書の【技術記事を書く技術】を読みました。
アウトプットが得意ではない人も、日頃アウトプットしている方も、ぜひ読んでみてほしいなと思える本でしたので、所感を述べていきます。
特に、アウトプットが得意ではない人・エンジニア初心者の方はぜひ読んでいただきたいと思いました。
なぜ技術記事をアウトプットするのか
明確に 「エンジニアへ情報共有をするため」 や 「困っている世の中のエンジニアに恩返しをするため」 が目的であることを強調されておりました。
正直、自分自身は「アウトプット活動を通じて自分自信の技術の理解を深めること」「市場価値をあげていきたいから」というのが第一の目的でやっている部分が大いにありました。
しかし、それはあくまでも結果であり、それを目的にするのは、アウトプット習慣の継続がむずかしい、とのことでした。
自分もこれまで様々なわからないことがあるたび、インターネットで検索して、QiitaやZenn、個人ブログなどの世の中のエンジニア達が残してくれた情報のおかげで、乗り越えられたことがたくさんありました。
同じような境遇になっている別のエンジニア達にむけて、自分も技術記事を書いていこうと改めて思いました。
自分が思っていたよりも技術記事のネタになるものはたくさんある
本では、筆者が考える技術記事のパターンが17パターン紹介されていました。
パターンごとに 「書きやすさ」「反響の得やすさ」 が記載されており、非常にわかりやすくまとめられていました。
個人的に、「トラブルシューティング系」 の記事は書きやすいなと思いました。
それに比べて「技術系オピニオン系」などは、バズリやすいですが書くのが難しいなと感じました。
また、昨今、AIの台頭でAIが生成した技術記事がありふれている中、 AIに置き換えられないような「やってみた・試してみた」系 の記事などを、今後書いていきたいと思いました。
技術記事の作成テクニックが実践的
本を読みながら感じたことは、直感的に「あれ、読みづらいな」と思う技術記事の特徴が言語化されていたのが印象的でした。
また、読みづらい特徴を基に、読まれやすい記事の作成テクニックが体系的にまとめられていました。
（例）タイトルは具体的にする、見出しで息継ぎさせる、文字とコードは50:50にする、など
個人的には、技術記事を書いていると話が逸れがちなため、 「タイトル」「はじめに」「まとめ」に一貫性をもたせる よう、意識していきたいと思いました。
記事を公開した後の反応に執着しない
技術記事を公開するためにはそれ相応の時間がかかります。
しかし、あくまでも「困っている世の中のエンジニアに恩返しをするため」が目的で技術記事を書いているので、反応がなくても執着しないように心がけようと思いました。
筆者は、技術記事を書き始めてから記事が小ヒットしたのが半年後、大ヒットしたのが2年後、とのことでした。
このことからも、一発ホームランを狙うのではなく、継続してアウトプットしつづけることが大事ということを再認識しました。
技術記事を書く習慣をつけること、継続が大事
目先の一回のバズリを期待するのではなく、中長期でのメリットが重要であるとのことでした。
技術記事を書いていると、その技術を深ぼるため色々調べたりします。
そうすることでその技術に対して自分自身の理解も深まり、スキルアップにつながります。
また、社内外にも自分自身の技術力のアピールにつながります。
こうした中長期のメリットを意識して、技術記事を書くことを継続していきたいと思いました。
また、継続のモチベーションとしては、個人的には下記があると思っております。
- 少なくとも誰か1人くらいは助かってるはず、と思う。
- （生成AIが台頭してきたとはいえ）ユーザーが生成AIで調べたときに、生成AIがWEB上に公開されている自分の技術記事を学習することで、間接的に自分の技術記事がユーザーのためになっている、と思う。
- QiitaやZennの記事はGithubで管理しているため、振り返りがしやすいし、編集しやすい。
※QiitaやZennの記事をGithubで管理する方法は、下記を参考にしてください。
これからもモチベーションを維持しつつ、技術記事を書く習慣を続けたいと思いました。
まとめ
ここまで、【技術記事を書く技術】を読んだ感想をまとめました。
技術記事を書くマインドセットや、技術記事の作成テクニック、実際の技術記事の実例添削などもあるため、非常に実践的ですべてのエンジニアに読んでほしいなと思える本でした。
ぜひ実際に手に取っていただき、みなさんと一緒に技術記事を書いていければと思います。