Road To RDoc - はてなかよっ！(この記事はRuby Advent Calendar jp: 2009の8日目の記事です．前の方はすがまさおさんで，後の方は@Sixeightさんです．) YARD プログラミング言語では，コメントから自動的にドキュメントを生成するツールが大抵用意されていて，RubyにもRDやRDocがあります．RDocは広く使われているので，Rubyistであれば使ったことがあるんじゃないかと思います．そんな中でDataMapperやHamlなど，最近使われるようになってきているのがYARDです．gemが用意されているので $ gem install yardでyardocやyriなどが使えるようになります． yardoc RDocみたいなもので，ソースからドキュメントを生成してくれます．書式は以下のような感じです(スタートガイドから引用)． # Converts the object into tex
