Share
Embed
Transcript
47 slides
-
自己紹介 毛利勝久(コンテンツ本部第3グループ所属の編集者) • 企業のオウンドメディアを中心に コンテンツマーケティング に協力するチーム • メディア(媒体)の設計‧運⽤およびコンテンツ制作を仕事としています • 主にテック領域(技術記事、テック企業の記事広告、エンジニアのキャリア)を担当
• 前職から含めると編集者歴は30年になります @mohri / id:mohri -
これから話すこと ソフトウェアエンジニアのアウトプットを編集していて感じたことなど • ソフトウェアエンジニアはどんなアウトプットをするのか? • なぜソフトウェアエンジニアにはアウトプットが大切なのか? • 技術ブログの役割 • エンジニアごとにさまざまな技術ブログの書き方・考え方がある
• 書いた記事を広くいろいろな人に届けたいと考えたときにできること • オウンドメディア編集者としての視点 +おまけ • 記事を書くときに気をつけたい目次と構成のこと -
なぜテックブログは書かれるのか? • エンジニア自身→ アウトプットは最大の学び・プレゼンスの向上 など • 所属企業 → 会社のプレゼンスの向上 →
エンジニア採用 • コミュニティが情報共有を求めている -
なぜテックブログは書かれるのか?(再掲) • エンジニア自身→ アウトプットは最大の学び・プレゼンスの向上 • 所属企業 → 会社のプレゼンスの向上 → エンジニア採用
• コミュニティが情報共有を求めている ここからは書き手=読み手にフォーカスして話していきます -
アウトプット駆動のため 曽根壮大さん YAPC::Hiroshima 2024のゲストスピーカー・曽根壮大さんが語る YAPCの思い出とその魅力 「 小さな勉強会でしゃべると、それについて知っている人が教えてくれる。「次までに調べてきます」と言って、ネク ストアクションを積んで、次の登壇までにそれをやる、というふうに「勉強会駆動で勉強する」ことが多かったです ね。 ブログに書いたことについても教えてくれたり
、その内容について発表するとまた教えてくれる人が現れたりし て、アウトプット駆動がTwitterや勉強会を通じて先に起きていた。」 -
他の人に伝える(喜ばせる)ため 和田裕介さん Cloudflareで動くフレームワークを和田裕介さんがオープンソースで開発する理由 「僕はその代わり「こういうものを作ったら他の人は喜ぶだろうな 」ということを発見したり、それを発信するのが 得意なんです。ブログの記事にしたり、セミナーで発表したり。そういうふうにプログラミングが得意でなかったと しても、技術を追求し続けることはできるんです。」 「エンジニアが技術ブログを書くことは多いですが、バズる記事はそう多くないですよね。広く読まれる記事にした いのなら、他で読めない内容になるまで突き詰めないと意味がありません 。「ちょっと試しにやってみました」と
いうチュートリアル的な記事にもそれはそれで価値はありますが、 プレゼンスの向上を目的に発信するならそこ で終わらないようにするといいですね。」 -
モチベーションに応じて読者を選ぶ 想定読者をどこに置くかで、記事の書き方も変わってくる 想定読者の種類 • 自分自身 • 社内のエンジニア • あるコミュニティに属するエンジニア •
不特定多数日本中のエンジニア 想定読者が変わればブログの目的も変化する -
SNSとSEO:流入元の 2つの観点 SNSとは、はてなブックマークや X(Twitter)など • 記事公開時に筆者の周囲から読者が広がる • この拡散が短期的にはとても重要 • 記事によってプラットフォームが異なることもあって興味深い
でも長期的には検索されると嬉しい • 長期的にその技術が気になっている人に読まれる • 定番記事になると、ブログのファンも増える -
ふりかえったら次のサイクルを回す! 次のことを考えながら、また記事を書いてみよう! • テーマ設定:同じ話題をまた書くか? 深堀りするのか? 少し角度を変えるのか? • 想定読者:期待した読者に、期待した人数だけ読まれているか? ◦ そもそもその記事をほしい人ってどのくらいのコミュニティに刺さるのか?
• 想定している読まれ方・読後感:何を期待して記事を公開するのか? • 探されているキーワード:検索流入は取れたのか? 取りたいワードは何か? -
アウトラインはだいたいこうなる 構成を細かく分割していく • はじめに(序論) ◦ 自己紹介 ◦ 動機・モチベーション • やったこと(本論)
◦ 最初の実装 ◦ 改善した実装 • まとめ(結論) ◦ 分かったこと ◦ 感想 -
当然だけど本論が長くなる もっと細かく • やったこと(本論) ◦ 最初の実装 ▪ なぜその実装がよいと思ったか? ▪ 工夫したこと
▪ 何がよくなかったか? ◦ 改善した実装 ▪ 改善のアイデア ▪ 工夫したこと ▪ なぜうまくいったのか? -
4層になるとさすがにわかりずらいが …… もっともっと細かくなる • やったこと(本論) ◦ 最初の実装 ▪ なぜその実装が選択したか ▪
工夫したこと • 技術の選択 ▪ 何がよくなかったか? ◦ 改善した実装 ▪ 改善のアイデア • 別の技術を選択 ▪ 工夫したこと • 最初の工夫 • 次の工夫 • さらなる工夫 ▪ なぜうまくいったのか? -
こんなになることもある 工夫にも手間がかかったものとそうでないものがある • やったこと(本論) ◦ 最初の実装 ▪ なぜその実装が選択したか ▪ 工夫したこと
• 技術の選択 ▪ 何がよくなかったか? ◦ 改善した実装 ▪ 改善のアイデア • 別の技術を選択 ▪ 工夫したこと • 最初の工夫 • 次の工夫 ◦ 工夫を成功させるアイデア ◦ アイデアの実装 ◦ 実装をやり直した ◦ またまたやり直した • さらなる工夫 ▪ なぜうまくいったのか? -
まとめるとこんなアウトライン 論文ならまだしも、Webの技術記事がこうなってたらけっこう厳しい • はじめに(序論) ◦ 自己紹介 ◦ 動機・モチベーション • やったこと(本論)
◦ 最初の実装 ▪ なぜその実装が選択したか ▪ 工夫したこと • 技術の選択 ▪ 何がよくなかったか? ◦ 改善した実装 ▪ 改善のアイデア • 別の技術を選択 ▪ 工夫したこと • 最初の工夫 • 次の工夫 ◦ 工夫を成功させるアイデア ◦ アイデアの実装 ◦ 実装をやり直した ◦ またまたやり直した • さらなる工夫 ▪ なぜうまくいったのか? • まとめ(結論) ◦ 分かったこと ◦ 感想 -
思い切っていったんフラットにしてみる 論文ならまだしも、 Webの技術記事がこうなってたらけっこう厳しい • はじめに(序論) • 自己紹介 • 動機・モチベーション •
やったこと(本論) • 最初の実装 • なぜその実装が選択したか • 工夫したこと • 技術の選択 • 何がよくなかったか? • 改善した実装 • 改善のアイデア • 別の技術を選択 • 工夫したこと • 最初の工夫 • 次の工夫 • 工夫を成功させるアイデア • アイデアの実装 • 実装をやり直した • またまたやり直した • さらなる工夫 • なぜうまくいったのか? • まとめ(結論) • 分かったこと • 感想 -
項目をまとめられたりしないか? 1行や2行だけの項目はないか? 同じことを書いている項目はないか? • はじめに(序論) ← この見出し必要? • 自己紹介 ←
2行くらいで終わってない? • 動機・モチベーション • やったこと(本論) ← この見出し必要? • 最初の実装 ← この見出し必要? • なぜその実装が選択したか • 工夫したこと • 技術の選択 • 何がよくなかったか? ← よくなかったことと改善のアイデアが表裏一体だったりしない? • 改善した実装 ← この見出し必要? • 改善のアイデア • 別の技術を選択 • 工夫したこと • 最初の工夫 • 次の工夫 • 工夫を成功させるアイデア • アイデアの実装 • 実装をやり直した • またまたやり直した • さらなる工夫 • なぜうまくいったのか? ← 次の「分かったこと」と同じことを書いてない? • まとめ(結論) ← この見出し必要? • 分かったこと • 感想 ← 2行くらいで終わってない? -
それでこうまとめられるかも? 1行や2行だけの項目はないか? 同じことを書いている項目はないか? • (見出しなし)リードとして自己紹介 • 動機・モチベーション • 最初の実装方法として何を選択したか? ◦
その方向を実現するために選択した技術 • うまくいかなかったので改善することになった ◦ 改善のアイデアとしては別の技術を選択することに ◦ 最初の工夫 • 次の工夫 ◦ 工夫を成功させるアイデア ◦ アイデアの実装 ◦ 実装をやり直した ◦ またまたやり直した • さらなる工夫により成功! • ここから分かったこと・なぜうまくいったのか? ◦ 感想 -
書きやすい構造が、読みやすいとは限らない Web記事の構造について職業編集者が考えていること • インデントが深くなりすぎてないか? • 項目ごとの分量は揃っているか? • Web記事はフラットに上から下へと読み進める • 見出しが登場するタイミングが読むリズムを作る
• 子要素だけで成り立っている親要素はそもそも親が不要かも • 見出しは2段階くらいにまとめるのが実用的 • 目次だけを見て、何が書いてあるのかわかるように -
参考リンク 僕が考える テックブログを書く意義 と 書き方のすゝめ 初めての「技術ブログ」書き方のご紹介 - SORACOM公式ブログ 技術ブログを書くモチベが上がるサイトまとめ テックブログ執筆に役立つ心構え
- paiza times どうしてもやってしまいがちな「固有名詞間違いあるある」