📝

エンジニアはアウトプットをどこに書いたほうが良いか

2021/12/05に公開1件

Zenn

これは「「はじめに」の Advent Calendar 2021」5日目の記事です。

TL;DR

自分のおすすめ

秘密情報に当たる内容
- 社内の共有Notion/Wikiなど
対象読者が非エンジニア
- はてなブログ
対象読者がエンジニア
- Zenn
- Qiita

はじめに

12月に入り、自分の周りでもAdvent Calendarに対する記事投稿が活発になっています。
エンジニアにとってアウトプットは大事だと言われつつも自分もなかなか普段から出来ているわけではありません。
書く時間、書く内容もそうですが、いろんなサービスがあり、どこに書こうかと悩んでいる方もいるのではないでしょうか？(自分もそうでした！)

この記事ではそんな方たちに対して、筆者なりの一定の判断基準を提供します。
とはいえ最終的にどこに書くのか決めるのはご自身ですので、この記事のとおりに書くのが正解というわけではありません。その点はご了承ください。

判断基準は「内容・対象読者・書きやすさ」＋α

まず、大前提があります。
アウトプットは何でも良いです。
書きたい、共有したい、教えてあげたい、そういった欲求からくるものでも、何でも良いからメモしておこう、といったものでも、たった3行程度のサンプルコードでも良いです。
自分の学んだことを体系だってまとめてみることでも良いし、読んだ本の感想でも何でも良いです。
まず、書く内容を決めてください。
決めたら、以下の順番に沿って考えてみましょう。

候補とするサービスは以下の4つです。

https://zenn.dev/
https://qiita.com/
https://hatenablog.com/
https://note.com/

1. 内容に機密情報が含まれていないか

必ずチェックしてほしいことが1つだけあります。
その会社やプロジェクトのコード、特許、ドメインに関わるもの、そういった内容が含まれていないか。
含まれている場合は、パブリックの箇所でその記事を書いてはいけません。社内Slack/Notion/Wiki/Confluence/etc..などその中でルールに基づいて書いてください。

たとえ一部分でもコードをコピーして貼り付けたらただの漏洩です。
今年のはじめにあったようなGithubソースコード流出事件と同じようなことになります。

2. 誰向けか

エンジニア向け
非エンジニア向け
のどちらかなのかを考えます。

エンジニア向けなら、以下のいずれか

Zenn
Qiita
はてなブログ

非エンジニア向けなら、以下のいずれか

Note
はてなブログ

それぞれ、その属性の人達と親和性があるサービスを候補に出しました。

3. 書きやすさ

エンジニアからしたらドキュメントはマークダウンで記述したいです。(書きたい人が多いという印象）
残念ながら、Noteはマークダウンで記述する機能がありません(2021/12/05時点)
対象読者に非エンジニアが多いことは魅力ですが、それ以上に書くこと自体にストレスがたまる環境はモチベーション、継続に支障がでます。よってNoteは外します。

この時点で、非エンジニアを対象とした内容を書く場合、「はてなブログ」を使うことをおすすめします。
https://hatenablog.com/

+α

Zenn, Qiita, はてなブログのどこに書くのかというのは正直好みでも良いと思います。

はてなブログは技術以外のコンテンツも多い代わりに技術系の記事も非常に多く、ユーザー数も多いのではてなブックマークやシェアによって拡散される可能性が高いことは利点かもしれません。
バズったときの爆発力は強いと思います。

QiitaやZennはグーグルからのSEOに強く、QiitaであればLGTMされた記事はより上位に表示されやすくなるので閲覧数を稼ぎやすい利点があります。Zennにくらべ、Qiitaの方が全体のユーザー数やページビュー数は上だと思います。
Qiitaの特徴でいうと、スライドモードもあります(が、自分はあまり使っていない)

Zennには、はてなブログやQiitaにはない特徴があります。