ようへいの日々精進XP

よかろうもん

2019 年 07 月 24 日 (水)

ジョギング

  • 山王公園を 40 分
  • 懸垂 x 7 回
  • 暑さもあるが, 右足太ももの強い張りが気になる

生きたドキュメント

午前中はとあるシステムのドキュメントの整備を行ったけど, 以下のような気付きがあった.

  • ドキュメントは書いて終わりじゃなくて, ちゃんと更新し続けられなければ意味がない
  • 一箇所に集約することが大切, あっちにもこっちにも書くのは駄目絶対 (Github の README と社内 wiki の両方に書くとか...絶対に差分が出る)
  • 更新がストレスにならないようなフローを考慮する必要がある