プログラマーにドキュメントを書かせるには?
2012年1月17日 11:30
cheez 曰く、
本家 /. 記事「How To Get Developers To Document Code」より。
コードのドキュメントがきちんと作成されていない? 問題はプログラマー達にあるのではなく、プロセスにあると Fatal Exception の Neil McAllister 氏は言う (ネタ元) 。
「コードのドキュメントをきちんとまとめる開発者は非常に少ない。ドキュメントを書かせること自体が難題と言ってもいいだろうが、しかし不可能ではない」とのことで、同氏はドキュメントを作成する習慣を確立するためにも「ムチよりもまず飴」方式を採用すべきとだと提案する。多くの人と同じく、プログラマーだって命令よりもインセンティブの方が動機づけとなる。簡単な賞賛も大いに功を奏するが、他の手段を模索するのも良いだろう。彼らが週末にサポート業務で待機担当だったり、またアップデート作業で深夜に作業している時はないだろうか? 追加のドキュメント業務に精を出した彼らにはそういった他業務の負担を軽くしたりするのも一案だ。また、金銭的なインセンティブも有効なのはもちろんである。
/.Jer の経験から見て、プログラマーのドキュメント作成の壁となっているもの、そしてそれを取り除くコツはなんだろうか?
スラッシュドットのコメントを読む | デベロッパーセクション | プログラミング | デベロッパー