Qiitaの記事を書くとき 工夫したこと

【LTイベント】Qiita Night〜記事投稿イベントお疲れ様会〜 - connpass
https://increments.connpass.com/event/216557/

Transcript

1. Qiitaの記事を書くとき
   工夫したこと
   @y_catch
   

   View Slide

2. 自己紹介：可知 豊
   ⚫ フリーのテクニカルライター
   ⚫ ZDnet、CodeZine
   ⚫ オープンソースライセンス本
   ⚫ paizaラーニング 動画制作
   ⚫ Hexabase マーケティング
   企業向けシステムのバックエンドクラウドサービスを提供
   https://www.catch.jp
   

   View Slide

3. Hexabaseとは
   企業向けシステムのバックエンドクラウドサービスを提供
   

   View Slide

4. サマリー
   ⚫ 書いてきた記事
   ⚫ そのとき工夫していたこと
   ⚫ ふだんの心がけ
   

   View Slide

5. Qiitaに書いた記事：8本
   129
   19
   462
   0
   

   View Slide

6. 習慣：調べものするときメモを残す
   ⚫ 調べる項目をあらかじめリストアップ
   ⚫ 調査項目の漏れをなくす
   ⚫ メモを更新しながら作業する
   ⚫ 調べたい項目が増えたら、メモを更新
   

   View Slide

7. アウトプット先
   とりあえず自分用メモの保存先＋外部へのアピール
   外部サービス
   • Qiita
   • Zenn
   • Scrapbox
   ブログ
   • catch.jp blog
   • オープンソース・ライセンスの談話室
   • パソコンで文字入力
   • Heppocode Garage
   Wiki
   • PukiWiki
   • 自作Wiki
   

   View Slide

8. さっきのメモを記事化
   

   View Slide

9. ある日、マーケティングの会議で
   かみわない 多彩な人材の集まり
   • マネジメント
   • 営業
   • プロモーション
   • エンジニア
   共通の知識・体験が少ない
   ↓
   Webシステムの発展を
   レクチャーしたら好評だった
   

   View Slide

10. View Slide

11. たまたま、3月末だった
    新人教育の時期 ⇒ 使われるかも
    全力で乗っかる
    

    View Slide

12. ある日、エンジニアの会議で
    かみわない
    サーバーレス？
    • Firebase
    • Laravel / Ruby on Rails
    • AWS / Azure
    人によってイメージが違う？
    

    View Slide

13. Zennのバックエンドは、
    Ruby on RailsのAPI onlyモードを使用
    

    View Slide

14. View Slide

15. 5月の特集に、全力で乗っかる
    

    View Slide

16. Zennでも記事を公開してみた
    https://zenn.dev/catch
    

    View Slide

17. いつも、ありがとうございます。
    Qiitaをはじめ、
    アウトプット先が簡単に確保
    

    View Slide

18. ふだんの心がけ
    調べたらメモを残す
    • 試したいこと、試したこと、その結果
    • 関連ページのリンク（あとから見つからない）
    読者(未来の自分を含む)のため、共通の前提知識を網羅する
    記事化するときは、最初に構成を考える
    • 書く内容を箇条書き
    • 先に構成を考えておくと、本文を書くときに楽になる
    • どこまで書いたか進捗把握しやすい
    • 時間順、PREP
    

    View Slide

19. Hexabase も、よろしくお願いします
    企業向けシステムのバックエンドクラウドサービスを提供
    

    View Slide

20. ご清聴ありがとうございました
    

    View Slide