doxygen楽しいけれど

現在コードのリファクタリングを行っているのですが、ついでに(ほとんど書かれていなかった)各コードやクラスの役割をドキュメント化しています。文章でクラスの役割を説明していくことで、そのクラスへの理解が深まる気がします。しかし、これが本当に仕事をしていることになっているのかというと自信が無いです。自分はただキーボードを叩いてツールを起動して、丁寧な散髪屋さんのように、カットをほぼ終わらせてからも、ミリ単位でそろえようとしているだけなんじゃないだろうか、と。
まあ、1年目は効率を度外視して色んなやり方に挑戦しようと心に決めているので、とにかくやってみることにします。