ブログってどうやって書くの？

インフラエンジニアの伊藤です。
弊社の技術ブログというものをオープンするにあたって、
必要なのはもちろんなんといっても「ブログを書く」ということ。

ただ、今まで弊社でこういった試みをしたことがないので、
ブログを書くって難しいと考えている人もいるんではないかなと思います。

で、普段ブログを運営している僕がブログの書き方をまとめとかないとなーと考えたのですが、
せっかくなのでこれを記事としてまとめてしまいたいと思います！

ということで、ビヨンド技術ブログ一発目は、まさかの社内向けということになるのですが、ブログの書き方です！

日記ではなく情報を書く

技術ブログなので、このことはあって当然なのですが、
ブログって何かなって考えたときに僕が思うのは、「情報を提供すること」という結論に至ります。

例えば「僕が昨日オムライス食った」なんてことは誰も求めてないですよね。
有名人の日常ならそれだけでネタになりますけどね。。

こういった技術ブログにたどり着くのは、何か困ったときのはずです。
なので、「困ったことを解決出来ることが書いてある」べきだと考えます。

ということは…「僕が昨日オムライス食った」をもし記事にするのであれば、
「今話題の○○という洋食屋でオムライスを食べた」っていうような記事ならどうでしょう？

この場合、主語が「僕」から「お店」に変わりますよね。
ということは、僕というものを出しても何も解決にはならないけど、
お店のことが知りたい人であれば、どんなお店が知ることが出来て解決には繋がるのではないでしょうか。

これなら情報といえそうですよね。

困っている人を助けることが出来るブログでありたいものですね。

見やすさを考える

書くにあたって、情報を書くのはいいんだけど、
それがわかりにくいものだったらどうしましょう。

例えば1行にずーっと改行もなく書くとか。
さっきの文章を1行にまとめます。

技術ブログなので、このことはあって当然なのですが、ブログって何かなって考えたときに僕が思うのは、「情報を提供すること」という結論に至ります。例えば「僕が昨日オムライス食った」なんてことは誰も求めてないですよね。有名人の日常ならそれだけでネタになりますけどね。。こういった技術ブログにたどり着くのは、何か困ったときのはずです。なので、「困ったことを解決出来ることが書いてある」べきだと考えます。

どうですか？見にくいですよね。。読む気が失せる！！
適度な改行とかはすごく大事です。

見やすさは視覚的な点もありますが、もう1つあります。

それは「わかりやすさ」という意味です。
技術ブログなので、専門的な言葉はたくさん出てきますが、そこをわかりやすく書くのが大事。

• なぜこうなったのか？
• 結論に至った理由は？

この辺りは明確に書かないと、エンジニアの方も納得してくれないですよね…

書き方の流れとしてはこんな感じがいいんですかね。

1. 困ったことがある
2. じゃあどうすれば解決するのか？
3. 何故そのことをするのか？

あとは細かいテクニック

ちゃんと見出しを付けるとか、途中に画像を用いるとか、URLは日本語のままにしないほうがいいとか…
割りと細かいところがありますが、これは割愛しちゃいます。

まとめ

っていうように、まとめも書くのも大事ですね！

特に長い文章だと、最後まで読んだときにどんな情報だったかがわからなくなることがあります。
なので、最後に簡単なまとめを書いておくと親切ですよね！

ブログを書く上で大事なことは、この2つになります。

• 情報を提供する
• わかりやすさを追求する

この2つを基本として、後は肉付け（細かなテクニック）を付けていくのがいいのではないでしょうか。
こうして、色んな情報を載せていきたいですね！