うまくいくドキュメント運用の視点

Transcript

1. うまくいくドキュメント運用の視点
   1
   

   View Slide

2. 2
   しいたけ（すずきたけし）
   @shitake4
   

   View Slide

3. ゴール
   1 ドキュメント運用できている状態（理想）が分かる
   2 理想の為に何を検討すればいいのか分かる
   3
   

   View Slide

4. ドキュメント運用ができている状態
   とは何か？
   4
   

   View Slide

5. 運用できてる状態
   1 読み手がドキュメント管理ツールから情報を探せる
   2 読み手がドキュメント管理ツールから情報を利用する
   3 書き手がドキュメント管理ツールに情報を書く
   5
   

   View Slide

6. 運用できてる状態
   ドキュメント管理
   システム
   (Qiita Team,
   Notion等)
   ①情報を探す
   書き手
   読み手 ③情報を書く
   ②情報を利用
   6
   

   View Slide

7. 読み手が情報を利用するフロー
   7
   

   View Slide

8. 読み手の行動
   情報を探す
   ドキュメン
   トを読む
   使えるか
   判断する
   情報を
   利用する
   欲しい情報
   がある
   8
   

   View Slide

9. 読み手が
   情報の利用をあきらめる場合
   9
   

   View Slide

10. 探すのをあきらめる場合
    情報を探す あきらめる
    欲しい情報
    がある
    あきらめる理由
    欲しい情報が見つけられない
    10
    

    View Slide

11. あきらめる
    読むのをあきらめる場合
    情報を探す
    ドキュメン
    トを読む
    欲しい情報
    がある
    あきらめる理由
    ドキュメントがわかりにくい
    11
    

    View Slide

12. あきらめる
    利用をあきらめる場合
    情報を探す
    ドキュメン
    トを読む
    使えるか
    判断する
    欲しい情報
    がある
    あきらめる理由
    古い情報で参考にしかならない
    12
    

    View Slide

13. まとめ　利用をあきらめる場合
    1 欲しいものが見つからない
    2 ドキュメントがわかりにくい
    3 古い記事で参考にしかならない
    13
    

    View Slide

14. まとめ　読み手の為の改善点
    1 ドキュメントを探しやすくする
    2 ドキュメントを読みやすくする
    3 ドキュメントを最新の状態に保つ
    14
    

    View Slide

15. 書き手が情報を書くフロー
    15
    

    View Slide

16. 書き手の行動
    記事を書く 共有する
    書きたい
    という思い
    情報を利用
    してもらう
    16
    

    View Slide

17. 書き手が
    情報を書かない場合
    17
    

    View Slide

18. 書きたい
    理由がない
    書かない理由
    書かない理由
    書きたい理由（インセンティブ）がない
    18
    

    View Slide

19. あきらめる
    書くのをあきらめる理由
    あきらめる理由
    どう書けばいいのかわからない
    書きたい
    という思い
    19
    

    View Slide

20. まとめ　書き手の為の改善点
    1 ドキュメントを書きたくさせる
    2 ドキュメントの書き方をわかってもらう
    20
    

    View Slide

21. まとめ　改善点
    1 ドキュメントを探しやすくする
    2 ドキュメントを読みやすくする
    3 ドキュメントを最新の状態にする
    4 ドキュメントを書きたくさせる
    5 ドキュメントの書き方をわかってもらう
    21
    

    View Slide