nDiki : 形式知

形式知 (explicit knowledge)

2019年10月31日 (木)

トライアル実装について書き出して情報発進するということ

保守が難しくなってきたライブラリを使うのをやめて、まだ導入していない新しいライブラリを使う実験的取り組みしていている担当者に「ドキュメントにまとめておいて欲しい」とリクエストしたら「誰が何のために読む想定で書けばよいか」という良い質問をもらった。質問を受けてドキュメント化で期待する価値について伝えられるよう整理しなおした。

ドキュメント化で期待する価値

今回のトライアル実装のドキュメント化で期待する価値は以下と考えている。

  • 個人の学習: 今回の取り組みメンバの理解が深まる。
  • 資料化: ソースコードから読み取りにくい 「なぜそういう設計・実装にしたか」を今後保守する人が理解する時の助けになる。
  • 組織の学習: 今後同じライブラリを使うことになる組織の他のメンバが将来参考にできる。

ということで「今のチームメンバ」「将来のメンテナ」「将来の組織の他のメンバ」が読者の想定だ。

「詳細設計書」をまとめるより「今回やったこと」「分かったこと」「考えたこと」「気付いたこと」を整理して書き出すことが、形式知化とナレッジ共有に役立つと考えている。

「ドキュメントにまとめておいて欲しい」には「成果物としてドキュメントを残して欲しい」だけでなく「情報発信をするメリットを知って欲しい」という思いも含んでいたりする。

[ opinion ]

スポンサード リンク
[ 10月31日全て ]

About Me

Naney Naney (なにい)です。株式会社ミクシィで SNS 事業の部長をしています。

nDiki1999年1月に始めたコンピュータ日誌を前身とする NaneyWeb 日記(兼パーソナルナレッジベース)です。ちょっとしたノートは nNote にあります。

※内容は個人的見解であり所属組織とは関係ありません。

月別インデックス
Process Time: 0.050266s / load averages: 0.67, 0.72, 0.61
nDiki by WATANABE Yoshimasa (Naney)
Powered by DiKicker