Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
うまくいくドキュメント運用の視点
Search
しいたけ@shitake4
June 02, 2020
Business
0
650
うまくいくドキュメント運用の視点
しいたけ@shitake4
June 02, 2020
Tweet
Share
More Decks by しいたけ@shitake4
See All by しいたけ@shitake4
議論を進めるファシリテーション
shitake4
1
790
Other Decks in Business
See All in Business
パーソルクロステクノロジー_GS統括本部_SSOL統括本部_紹介資料
pptssol
0
17k
LGBTQ__support_WOMEN_女性として働くということ_DEI
freee
1
270
SMat CultureDeck
smartshopping
2
25k
マネジメント本から学ぶチームで価値を生む考え方 / Concepts for Creating Value in Teams Learned from Management Books
shuzon
5
990
(3枚)人材価値を測る5つのスキルと欠落的欠点とは?
nyattx
PRO
2
230
Artopeer会社紹介資料
dazyk
0
300
ESG x VC レポート:VC・スタートアップのESGへの 取り組み状況を踏まえたVCにおけるESGの戦略的要諦・アクション
mpower_partners
PRO
0
740
AmbientNavi 紹介資料
ambientnavi0329
0
400
インキュデータ会社紹介資料
okitsu
1
25k
20240712_CM_Odyssey
hideki_ojima
1
190
ブレイン・ラボ‐会社説明資料
blhr_nktk
0
18k
名古屋エンジニア LT 大会
sasuke0339
0
320
Featured
See All Featured
How to Think Like a Performance Engineer
csswizardry
4
590
Fontdeck: Realign not Redesign
paulrobertlloyd
79
5.1k
We Have a Design System, Now What?
morganepeng
46
7k
Producing Creativity
orderedlist
PRO
340
39k
A better future with KSS
kneath
231
17k
10 Git Anti Patterns You Should be Aware of
lemiorhan
652
58k
Building Effective Engineering Teams - LeadDev
addyosmani
47
2.2k
Designing for humans not robots
tammielis
247
25k
Debugging Ruby Performance
tmm1
71
11k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
16
1.6k
Building Better People: How to give real-time feedback that sticks.
wjessup
357
18k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
26
1.8k
Transcript
うまくいくドキュメント運用の視点 1
2 しいたけ(すずきたけし) @shitake4
ゴール 1 ドキュメント運用できている状態(理想)が分かる 2 理想の為に何を検討すればいいのか分かる 3
ドキュメント運用ができている状態 とは何か? 4
運用できてる状態 1 読み手がドキュメント管理ツールから情報を探せる 2 読み手がドキュメント管理ツールから情報を利用する 3 書き手がドキュメント管理ツールに情報を書く 5
運用できてる状態 ドキュメント管理 システム (Qiita Team, Notion等) ①情報を探す 書き手 読み手 ③情報を書く
②情報を利用 6
読み手が情報を利用するフロー 7
読み手の行動 情報を探す ドキュメン トを読む 使えるか 判断する 情報を 利用する 欲しい情報 がある
8
読み手が 情報の利用をあきらめる場合 9
探すのをあきらめる場合 情報を探す あきらめる 欲しい情報 がある あきらめる理由 欲しい情報が見つけられない 10
あきらめる 読むのをあきらめる場合 情報を探す ドキュメン トを読む 欲しい情報 がある あきらめる理由 ドキュメントがわかりにくい 11
あきらめる 利用をあきらめる場合 情報を探す ドキュメン トを読む 使えるか 判断する 欲しい情報 がある あきらめる理由
古い情報で参考にしかならない 12
まとめ 利用をあきらめる場合 1 欲しいものが見つからない 2 ドキュメントがわかりにくい 3 古い記事で参考にしかならない 13
まとめ 読み手の為の改善点 1 ドキュメントを探しやすくする 2 ドキュメントを読みやすくする 3 ドキュメントを最新の状態に保つ 14
書き手が情報を書くフロー 15
書き手の行動 記事を書く 共有する 書きたい という思い 情報を利用 してもらう 16
書き手が 情報を書かない場合 17
書きたい 理由がない 書かない理由 書かない理由 書きたい理由(インセンティブ)がない 18
あきらめる 書くのをあきらめる理由 あきらめる理由 どう書けばいいのかわからない 書きたい という思い 19
まとめ 書き手の為の改善点 1 ドキュメントを書きたくさせる 2 ドキュメントの書き方をわかってもらう 20
まとめ 改善点 1 ドキュメントを探しやすくする 2 ドキュメントを読みやすくする 3 ドキュメントを最新の状態にする 4 ドキュメントを書きたくさせる 5
ドキュメントの書き方をわかってもらう 21