保守が難しくなってきたライブラリを使うのをやめ、まだ導入していない新しいライブラリを使う実験的取り組みをしている担当者に「ドキュメントにまとめておいてほしい」とリクエストしたら「誰が何のために読む想定で書けばよいか」という良い質問をもらった。ドキュメント化で期待する価値について伝えられるよう整理しなおした。
今回のトライアル実装のドキュメント化で期待する価値は以下と考えている。
ということで「今のチームメンバ」「将来のメンテナ」「将来の組織の他のメンバ」が読者の想定だ。
「詳細設計書」をまとめるより「今回やったこと」と「分かったこと」「考えたこと」「気付いたこと」(わかき)を整理して書き出すことが、形式知化とナレッジ共有に役立つと考えている。
「ドキュメントにまとめておいてほしい」には「成果物としてドキュメントを残してほしい」だけでなく「情報発信をするメリットを知ってほしい」という思いも含んでいたりする。
[ opinion ]
4年使った Xperia Z5 SO-01H から Google ストアで購入した Pixel 4 に機種変更するので月末である今日をもってケータイ補償サービスを解約した。ケータイ保障サービスは結局過去の端末も含め1回も使わずに済んできてしまったなあ。
Pixel 4 は Google ストア上で Preferred Care (延長保護プラン)についての表示があったので、もしかしたら利用できるかなと思っていたのだけれど、現在米国のみとのこと。今のところ日本での認定修理担当パートナー(保証対象外)は iCracked だけのようだ。
Naney (なにい)です。株式会社ミクシィで SNS 事業の部長をしています。
nDiki は1999年1月に始めたコンピュータ日誌を前身とする Naney の Web 日記(兼パーソナルナレッジベース)です。
#nNote タグがついている記事は他の記事に比べて、より断片的・未整理・不完全なちょっとしたノートです。まだ結論に至っていない考えなども含まれます。頻繁/大幅に更新したり削除したりすることがあります。 それとは別に nNote にもちょっとしたノートがあります。
※内容は個人的見解であり所属組織とは関係ありません。