読みやすいブログの書き方 | DevelopersIO

渡辺です。 以前、JUnit実践入門を執筆した経験もあり、社内でもブログの文章が読みやすいと評価を受けています（内容はともかくｗ）。 折角なので、技術ブログを書くときに注意する点をまとめてみました。 はじめに結論を書く 一番大切なこと、それは結論を最初に書くことです。 エンジニアには時間ありません。 はじめに、何が言いたいか、何を解決するのか、そこを最初に書かないと、読んでて苦痛です。 回りくどかったり、話がブレブレだと最悪です。 「XXの時、解決するにはXXする」とか「XXについて一言でまとめるとXXです」など、最初にまとめを書きましょう。 見出しですべてを伝える意識を持つ 見出しは大切です。 見出しを追っていけば、内容が頭に入ってくるのがベストです。 「見出しをまとめてしまったら、本文に書くことなくなった(´・ω・`)」となれば完璧です。 まさに今、蛇足しか書いてません（笑）。 短い文

[ytRino]

ブコメも短く簡潔に

[tanimiyan]

Tech BLOGの書き方、ね。ビジネス文書にも通じるところあり。「結論を先に」はホントそう。

[ijufumi]

分かりやすくまとまってていい感じです。 文章の書き方も勉強しなければ！

[retire2k]

ネタ系はオチを最初に持ってきたらダメｗ

[tkmoteki]

読みやすいブログの書き方 via @nuzzel

[Sahuan]

良い

[masaru_b_cl]

文章力の基本 https://www.amazon.co.jp/dp/4534045883 や 理科系の作文技術 https://www.amazon.co.jp/dp/4121006240 もどうぞ

[b4takashi]

技術系ブログだけでなくいろんなところに応用できそう

[kagerou_ts]

説明や解説向けで効果を発揮しそう。この文章自体がすらっと完結に分かりやすくて素敵。

[mano-junki]

ここの人が言うと説得力が違うなー

[nobuoka]

『短い文章を繋げる』 の大事だよなー。 と思ってはいるんだけど接続詞を多用しがち。 気を付けたい。

[sue445]

知見だ