rdocのデフォルトのテンプレートが非常にダサくて、なかなか使いづらい。mislavのhannaを使えば、こんなにスタイリッシュになる：

おまけとして、簡単なメソッド検索もできます。また、テンプレート自体はhamlで書いていて、なかなか読みやすい。「スケールできる」ことが売りらしいけど、まぁ意味不明な自慢だよね。

インストール

1. rdoc 2.3.0をインストールする。現在のhannaはまだ最新rdocの2.4.xに対応していないからご注意ください。
   shell-unix-generic>>
   sudo gem install rdoc -v 2.3
   <<--
2. githubをgemのsourceに追加
   shell-unix-generic>>
   gem source add http://gems.github.com
   <<--
3. インストール
   shell-unix-generic>>
   gem install mislav-hanna
   <<--
4. インストール済みのgemのrdocをhannaにする
   shell-unix-generic>>
   hanna --gems
   <<--
5. これからインストールするgemのrdocもhannaにするため、.gemrcに以下の一行を追加する
   yaml>>
   rdoc: --inline-source --line-numbers --format=html --template=hanna
   <<--

ちなみに、今使っている.gemrcはこんな感じ：
yaml>>

:benchmark: false
:update_sources: true
:sources:

• http://gems.rubyforge.org/
• http://gems.github.com
  :bulk_threshold: 1000
  :backtrace: false
  :verbose: true
  rdoc: --inline-source --line-numbers --format=html --template=hanna
  <<--

もっと凄いドキュメント検索：sdoc

railsapiで使っているsdocというやつもある。これの検索機能がなかなかすばらしい。ただし、今のところは単体のプロジェクトでしか使えなくて、gemからtemplateとして指定することができないみたい。また、githubへのリンクもgithubを使っていないプロジェクトにとってはちょっと魅力が薄れる。にもかかわらず、とても魅力的だな。
shell-unix-generic>>
gem install voloko-sdoc --source http://gems.github.com
<<--
rdocは2.3ではなく、2.4が必要のようです。
shell-unix-generic>>
gem install rdoc -v 2.4
<<--
適当なプロジェクトで実行：
shell-unix-generic>>
cd
sdoc -N .
<<--
で、できあがり

参考

• mislav's hanna on github
• Offline Gem Server Rdocs
• Labnotes> Buildr: how we generate the documentation, Web site and PDF
• voloko's sdoc on github

便利そうなサービスを見つけたので紹介します。

RDocul.us

いつでも最新のRDoc情報を配信してくれるサービスのようです。
ドキュメントはRDocがあればだいたい事足りるので、非常に助かります。

欲を言えばインクリメンタルサーチにも対応して欲しい :-)

日ごろ何かとお世話になっているRDocのバージョン2.0.0がリリースされたようです。

rdoc version 2.0.0 has been released!

RDoc is an application that produces documentation for one or more Ruby source files. RDoc includes the rdoc and ri tools for generating and displaying online documentation.