ドキュメント書き
開発をちょいとお休みして、ドキュメント書き。Ruby用語集の
ドキュメント:
matzの苦手なもの。彼は普段から「ソースがドキュメントだ。バグも完全に記述されている」と主張しているが、誰も受け入れない。当り前だ。
が身にしみる。
ドキュメント書きには標準っぽいRDocを利用。
- http://pub.cozmixng.org/~the-rwiki/rw-cgi.rb?cmd=view;name=RDoc%B3%D0%A4%A8%BD%F1%A4%AD
- RDoc Documentation
ドキュメントと同時に、わかりにくい変数名やら複雑な関数も修正。cmdよりcommand_queのほうがいいだら。あと、汚い気がする実装には"美しくない"とコメントを入れておいた。そのうち直そう。
あと、しらないうちにfactory methodを使っていたことに気がつく。ちょっと感動。