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

by Natty | なってぃ

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

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

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

ドキュメント化とは？ ©BLUEISH 2025. All rights reserved. そのドキュメント、ちゃんと息してる？〜使われ続ける“生きた”ドキュメントの育て方〜ドキュメント化（英：Documentation）とは、ある事柄に関するデータや情報、記録などを、他の人が理解しやすい形式の文書として体系立ててまとめること。また、そのようにしてまとめられた文書群。出典：IT用語辞典 e-Words ドキュメント化とは？ 11

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

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

Slide 22

Slide 22 text

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

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

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

Slide 27

Slide 27 text

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

Slide 28

Slide 28 text

Slide 29

Slide 29 text

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

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

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