nDiki : 2019年10月31日

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

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

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

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

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

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

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

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

• すべての情報を共有する。情報閲覧者が判断する。
• 私が情報発信を勧める理由
• 「わかき」分かったこと・考えたこと・気付いたこと

[ opinion ]

NTTドコモ ケータイ保障サービス 解約

4年使った Xperia Z5 SO-01H から Google ストアで購入した Pixel 4 に機種変更するので月末である今日をもってケータイ補償サービスを解約した。ケータイ保障サービスは結局過去の端末も含め1回も使わずに済んできてしまったなあ。

Pixel 4 は Google ストア上で Preferred Care (延長保護プラン)についての表示があったので、もしかしたら利用できるかなと思っていたのだけれど、現在米国のみとのこと。今のところ日本での認定修理担当パートナー(保証対象外)は iCracked だけのようだ。

今日のさえずり: ミーティング中で知らんぷりしていたけれど、やっぱり 11:00 過ぎに地震があったのね。

2019年10月31日

• 06:00 系統。 渋谷区東1 RICOH GR III #GR #GRIII #GR3 https://t.co/memP6QLI2b
• 06:15 日の当たる場所。 青山学院大学 RICOH GR III #GR #GRIII #GR3 https://t.co/g5alFmo8tJ
• 09:52 2019年10月31日 #朝の渋谷 #渋谷リバーストリート RICOH GR III HardBW #GR #GRIII #GR3 https://t.co/NeC6vGuckL
• 11:45 明日グランドオープンの渋谷スクランブルスクエア。 #渋谷スクランブルスクエア RICOH GR III #GR #GRIII #GR3 https://t.co/qtgjZpGmc4
• 11:55 青山学院大学青山キャンパスでは明日から青山祭。
• 12:18 ミーティング中で知らんぷりしていたけれど、やっぱり 11:00 過ぎに地震があったのね。
• 13:00 Pixel 4 にするので Xperia Z5 SO-01H のケータイ補償サービスを解約した。
• 17:45 日の当たる塀。 #金王八幡宮 RICOH GR III #GR #GRIII #GR3 https://t.co/Dtf2utwafk