そのドキュメントは誰がために

そのドキュメントは誰がために
@silpheed_kt
まっちゃ445復活祭 #ssmjp 2018/3/10

自己紹介
@silpheed_kt
Keiichi Tanaka
都内のゲーム開発会社で
ソフトウェア開発＋インフラ構築

ドキュメントとは
・　資料

ドキュメントとは
・　対象（読者）が

・　前提（環境、知識、経験等）のもとに

・　決裁者に逐一聞かなくても

・　必要なことが分かる

・　資料

ドキュメントの目的
・　何かが分かる

　　仕様、手順 etc

・　決裁者に逐一聞かなくても（ある程度）分かる

　　合意形成、省力化

「分かる」ことの前提
・　対象

　　誰が読むのか

・　前提

　　環境、知識、経験 etc

「分かる」とは
(1) 思い出せる
　　備忘録、議事録

(2) 役割分担のもとに業務が進められる
　　設計、実装、テスト etc

(3) 規定された状態を再現できる
　　環境構築 etc

→状態が1つのため「ある程度」ではない
→100％の再現性を目標とする

分からないドキュメントは読まれない
・　対象、前提が合致しない
・　再現できない
とはいえドキュメントだけでは分からない
・　「ある程度」の粒度は人によって異なる
・　内容が純粋に足りない、間違っている etc

確認＝必須コスト
とあるゲームの仕様書（企画→PG）
　メインの企画が決裁者
　サブの企画がドキュメント作成　※眼鏡っ娘

決裁者≠ドキュメント作成者
　決裁者の意図を正確に反映できない
→決裁者への確認が必要（必須コスト）

・ PG側

ドキュメントのみを信用すると時々間違える
→ドキュメント作成者への不信（ES低下）
→ドキュメントを読まなくなる（無駄なコスト）

※ES＝従業員満足度（Employee SaGsfacGon）

・企画（サブ）側　※眼鏡っ娘

読まれないドキュメントを作成
→PJ全体への不信（ES低下）
→「信用されない」ことへの不信（ES低下）
→徒労感（ES低下）

※ES＝従業員満足度（Employee SaGsfacGon）

確認を怠ると…

・　PJの不健全化
・　チーム内での相互不信
・　従業員の不健全化（離脱リスクの増大）

確認を怠ると…

・　PJの不健全化
・　チーム内での相互不信
・　従業員の不健全化（離脱リスクの増大）

→にゃーん

「そのドキュメントは誰がために」
・　目的、対象、前提条件を明確に

・　確認は必須コスト
　（確認するという意識、確認しやすい体制作り）

・　みんなが幸せになるドキュメント運用を！

ご静聴ありがとうございました

Recomendados