関数についてのコメントが少ない気がしていて，php doc 的なものないかなーと探してみたら ruby では rdoc なるものがあるらしい．
http://docs.ruby-lang.org/ja/1.8.7/library/rdoc.html

とはいえ，あまり効果的でもなさそうなので，適当に入出力くらいは書いておいてほしい