自由であるためにドキュメントを作る - 設計者の発言

前回記事で、ドキュメンテーションを重要視しない開発業者を避けるべきだと指摘した。同様の問題は、業務システムを内製した場合にも生じている。むしろ、ドキュメントレスな困ったシステムは、内製で生み出されているケースのほうが多いような印象が私にはある。 ドキュメントレスなシステムが重大なリスクを抱えていることを、ほとんどの経営者は認識していない。なぜなら、ドキュメントレスであってもシステムのあり方は内製担当者の「頭の中」に入っているので、彼に頼めば必要な改修はやってもらえるからだ。結果的に業務システムが、担当者のエンプロイアビリティ（雇用意義）を強化するための政治的ユーティリティと化すことを許してしまう。その歪みは、担当者がいなくなったときに一挙に顕在化する。いなくなった当人としては「後は野となれ山となれ」である。 業務システムがドキュメントレスになりがちな根本的な理由は、まさにここらへんにある。

[msykt]

本論の部分は同意だけど、前段の”政治的ユーティリティ”とか”ドキュメントをしっかり作ることは、ある意味で開発者の「自己否定」につながる”とか、そんなことあるのかな。無くて困るなら作れば良いだけかと

[vanbraam]

"今の会社でも、丁寧にドキュメントを作りながら地道に内製を進めている。なぜそんなスタイルを身につけたのかと訊くと、彼はこう答えた。「ひとつの会社にずっといたくないからですよ」"

[torazuka]

うっ……何かを思い出しかけて胃が

[northlight]

ドキュメントレスなシステムが重大なリスクを抱えている

[fumisan]

手離れしやすくするためにドキュメントを作る、という考えは同意。居残るために作らないという視点が面白いと思った。