Upgrade to Pro — share decks privately, control downloads, hide ads and more …

そのドキュメント、ちゃんと息してる? ~ 使われ続ける“生きた”ドキュメントの育て方 ~

Natty
March 12, 2025

そのドキュメント、ちゃんと息してる? ~ 使われ続ける“生きた”ドキュメントの育て方 ~

このLTでは、「そのドキュメント、ちゃんと息してる?」をテーマに、ドキュメントが化石化せず、使われ続けるためのポイントについて解説します。
生きたドキュメントを育てるための4つのステップを紹介し、実践しやすい具体的な方法もあわせて紹介しています。
ドキュメントを作って終わりにせず、活用し続けるためのヒントを得たい方の参考になれば幸いです!

“Is Your Documentation Alive?”
~ How to Keep It Relevant and Continuously Used ~

This LT explores the theme, “Is your document still breathing?”, focusing on how to prevent documentation from becoming outdated and ensuring it remains actively used.
It introduces four key steps to maintaining living documentation, along with practical and actionable methods.
If you want to go beyond just creating documents and learn how to keep them relevant and useful, this is for you!

Natty

March 12, 2025
Tweet

More Decks by Natty

Other Decks in Business

Transcript

  1. ©BLUEISH 2025. All rights reserved. 目次 そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    01 自己紹介 02 ドキュメント化とは? 03 ドキュメント化 Pros & Cons 04 “生きた”ドキュメントを育てるサイクル 05 まとめ 2
  2. 自己紹介 ©BLUEISH 2025. All rights reserved. 宮下 千波 Chinami Miyashita

    経歴 2017年:総合商社で法人営業を担当    2019年:セブ島へ留学    2020年:総合商社で貿易事務・経理を担当    2022年:株式会社BLUEISHに入社 趣味 邦ロック:ベース弾いてました    映画鑑賞:ミニシアターが好き    お香  :おすすめの香り大募集中 役職 ゼネラルマネージャー / プロジェクトマネージャー Xアカウント :@natty_natty2 54 そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜 4
  3. ドキュメント化とは? ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    ドキュメント化(英:Documentation)とは、 ある事柄に関するデータや情報、記録などを、 他の人が理解しやすい形式の文書として体系立ててまとめること。 また、そのようにしてまとめられた文書群。 出典:IT用語辞典 e-Words ドキュメント化とは? 11
  4. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 情報の散逸防止 業務品質の均一化 業務属人化の解消 作成コストの増大 柔軟性の低下 形骸化のリスク PROS CONS 14
  5. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 情報の散逸防止 業務品質の均一化 業務属人化の解消 作成コストの増大 柔軟性の低下 形骸化のリスク PROS CONS 15
  6. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 情報の散逸防止 業務品質の均一化 業務属人化の解消 作成コストの増大 柔軟性の低下 形骸化のリスク PROS CONS 16
  7. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 情報の散逸防止 業務品質の均一化 業務属人化の解消 形骸化のリスク PROS CONS 作成コストの増大 柔軟性の低下 17
  8. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 ドキュメントが更新されず形骸化する = ドキュメントの “化石化” 18
  9. ドキュメント化 Pros & Cons ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる?

    〜 使われ続ける“生きた”ドキュメントの育て方 〜 化石化を防ぎ、ドキュメントを “生きた”情報にするには? 19
  10. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    必要な情報の選定 ドキュメントの作成 編集権限の開放 定期的な更新と運用 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 誰 でも 理 解 しやすく、シン プルな形で整 理する。作 成 コストは 可 能 な 限 り 下 げ る。 関係者全員が簡単にアクセ ス・ 更 新 できるようにす る。 共 有 ・フィードバック・ 更 新を繰り返し、情報を“生か し”続ける。 1 2 3 4 “生きた”ドキュメントのサイクル 21
  11. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    必要な情報の選定 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 1 “生きた”ドキュメントのサイクル ドキュメントの作成 編集権限の開放 定期的な更新と運用 誰 でも 理 解 しやすく、シン プルな形で整 理する。作 成 コストは 可 能 な 限 り 下 げ る。 関係者全員が簡単にアクセ ス・ 更 新 できるようにす る。 共 有 ・フィードバック・ 更 新を繰り返し、情報を“生か し”続ける。 2 3 4 22
  12. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    必要な情報の選定 A. 感覚型 長年の経験や知見から、感覚的に対応する業務 B. 選択型 いくつかの選択肢から、適切な対応をする業務 C. 単純型 誰がやっても結果は同じ、単純な業務 23
  13. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    必要な情報の選定 A. 感覚型 長年の経験や知見から、感覚的に対応する業務 B. 選択型 いくつかの選択肢から、適切な対応をする業務 C. 単純型 誰がやっても結果は同じ、単純な業務 24
  14. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    ドキュメントの作成 誰 でも 理 解 しやすく、シン プルな形で整 理する。作 成 コストは 可 能 な 限 り 下 げ る。 2 “生きた”ドキュメントのサイクル 必要な情報の選定 編集権限の開放 定期的な更新と運用 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 関係者全員が簡単にアクセ ス・ 更 新 できるようにす る。 共 有 ・フィードバック・ 更 新を繰り返し、情報を“生か し”続ける。 1 3 4 26
  15. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    ドキュメント作成 3箇条 1. 1ドキュメント=1トピック テーマはいつも一つ。冗長にしない。 2. テンプレートを作る テンプレートなどを活用してフォーマットを統一することで、 誰でも同じ形式ですぐに作成できるようにする。 3. ビジュアルを活用 箇条書き・表・スクリーンショットを活用し、視覚的に伝わりやすくす る。「長い説明文=正義」ではない。 27
  16. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    編集権限の開放 関係者全員が簡単にアクセ ス・ 更 新 できるようにす る。 3 “生きた”ドキュメントのサイクル 必要な情報の選定 ドキュメントの作成 定期的な更新と運用 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 誰 でも 理 解 しやすく、シン プルな形で整 理する。作 成 コストは 可 能 な 限 り 下 げ る。 共 有 ・フィードバック・ 更 新を繰り返し、情報を“生か し”続ける。 1 2 4 29
  17. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    定期的な更新と運用 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 共 有 ・フィードバック・ 更 新を繰り返し、情報を“生か し”続ける。 4 “生きた”ドキュメントのサイクル 必要な情報の選定 ドキュメントの作成 編集権限の開放 何 でもかんでもドキュメン ト化しない。本 当に必 要な 情報を見極める。 誰 でも 理 解 しやすく、シン プルな形で整 理する。作 成 コストは 可 能 な 限 り 下 げ る。 関係者全員が簡単にアクセ ス・ 更 新 できるようにす る。 1 2 3 32
  18. “生きた”ドキュメントを育てるサイクル ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる? 〜 使われ続ける“生きた”ドキュメントの育て方 〜

    ドキュメント化後 3箇条 1. ドキュメントを関係者に共有する 2. 変更や追加点があれば、各自で更新する 3. 更新したら、すぐに関係者に共有する 33