diary日記2019-03-27人間の失敗を記したドキュメントは陳腐化しないSRE本を読んでからポストモーテムについて考えている。ポストモーテム(post-mortem)とは反省会、事後検討といった意味の言葉である。なにか予期せぬ失敗をしたときに書く文章だ。SRE本ではサーバシステム運用の文脈で使われた。仕事でドキュメントは大事だ。喋って何かを決めたり、ふりかえっても、文章で蓄積しないと何も残らない。われわれソフトウェアエンジニアがよく書くのは、設計とか仕様についてのドキュメントだろう。これらのドキュメントはしばしば陳腐化する。仕様やソフトウェアの使い方、環境構築のドキュメントはすぐに内容が古くなる。してわれわれは文章を書かなくなるのだが、どうやらポストモーテムは違う性質を持っている。いうのも、失敗を記録した文書は陳腐化しにくいのだ。過去に起こった事実を記録しているから。過去に起こったことを記述するので、原理的に内容を書き換える必要がない。知見が蓄積されていくのである。失敗した対象のシステムが使われなくなると、表面的にはその文章は不要となる。ところが、じつはそうでもない。失敗するのはいつでも人間なので、人間がどのように失敗したかを記したドキュメントはシステムが使われなくなっても有用だ。システムや仕様、そのときの環境について書いたドキュメントは陳腐化し、人間について書いたドキュメントは陳腐化しにくいのだ。人間は必ず失敗し、たいてい同じ失敗をくりかえす。陳腐化しないドキュメントを残せることと、失敗を再度起きないようにすることは別の問題だ。ここは留保しなければならない。日常的な行動を変えることができない人間が多いと、ドキュメントがあっても無駄だろう。これは、「愚者は経験に学び、賢者は歴史に学ぶ」で言い表される問題だ。組織文化の問題となるので、これについてはそのうち別の記事を書く。失敗について反省し文書を残すことは効率のよい投資である。将来にわたって使えるドキュメントにするには、起きた出来事と問題の構造、そのときの判断を具体的に書く必要がある。箇条書きではだめだろう。箇条書きは複雑な論理構造をもった問題をわかりやすく伝えるようにはできていない。ポストモーテムは必ず文章で書くようにしたい。22:34人間の失敗を記したドキュメントは陳腐化しないTweet広告を非表示にする関連記事2018-06-21ある日、「最新技術を使いたいが、ベストプラクティス(定番の手法)がなくて困る」的なことを耳にした。当...ある日、「最新技術を使いたいが、ベストプラクティス(定番の...2018-05-26グラタングラタン食べたくなったのでつくりました。土井善晴さんのレシ...2018-05-14さいきん読んだ本さいきん本をよく読むようになりました。Mode雑感イラスト、プログラミング、文章などは意図...redux-sagaのall([fork])パターンは、即座にfinallyに突入してしまうであること、できること、すること月別アーカイブはてなブログをはじめよう!non_117さんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。