Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
うまくいくドキュメント運用の視点
Search
Sponsored
·
Ship Features Fearlessly
Turn features on and off without deploys. Used by thousands of Ruby developers.
→
しいたけ@shitake4
June 02, 2020
Business
880
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
うまくいくドキュメント運用の視点
しいたけ@shitake4
June 02, 2020
Transcript
21 slides
うまくいくドキュメント運用の視点 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
More Decks by しいたけ@shitake4
See All by しいたけ@shitake4
議論を進めるファシリテーション
shitake4
1
1.2k
Other Decks in Business
See All in Business
3ヶ月で月額300万円削減 ── AWSコスト削減プロジェクトのリアル
o2mami
0
790
THE Impact Report 2026 /THE株式会社 2026年10月公開(訂正版)
yusukiwashita
0
340
株式会社アドバンテッジリスクマネジメント会社紹介資料
arm0020
0
77k
株式会社Plott Company Deck
plott
0
390
데이터 분석가의 커리어 설계
datarian
0
330
ピティナ・東音企画 採用資料
ptna_
0
580
AWS認定宇宙最速(未遂)受験芸人がAIB(AWS Certified AI Business Strategist)を宇宙最速(未遂)で受けてみた
alchemy1115
0
130
お客様と未来を描く 戦略&技術伴走
yoshi22
0
390
スクラムマスターのセルフケアは専門スキルの一部
emi0726
1
180
ラクスル会社紹介資料 / RAKSUL Introduction
raksulrecruiting
18
270k
ソニックガーデン経営組織論(2026/11版)
kuranuki
2
360
カンパニーデック
nessu_inc
0
1.5k
Featured
See All Featured
AI Search: Where Are We & What Can We Do About It?
aleyda
0
8.3k
Un-Boring Meetings
codingconduct
0
510
Keith and Marios Guide to Fast Websites
keithpitt
413
23k
Building Better People: How to give real-time feedback that sticks.
wjessup
371
20k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
234
18k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
141
35k
How Fast Is Fast Enough? [PerfNow 2025]
tammyeverts
3
990
Impact Scores and Hybrid Strategies: The future of link building
tamaranovitovic
0
490
Intergalactic Javascript Robots from Outer Space
tanoku
273
28k
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
tammyeverts
11
1.1k
Designing for Performance
lara
612
70k
Typedesign – Prime Four
hannesfritz
42
3.2k