適切なRDoc構文の適切で確実なリファレンスはありますか？

私は適切なRDoc構文のための良い、しっかりしたリファレンスを探しています。推奨事項？はっきりとわかるものが見つからないようです。

1. クラスメソッドとそのパラメータを文書化する方法
2. クラスまたはクラスメソッドの機能を文書化する方法。

公式のrdocの例は、GitHubソースとともにここにあります。

ドキュメントrdoc.rubyforge.orgは時のバージョンよりもより完全であるように思わrdoc.sourceforge.net（ちなみに2003更新日を持っています）。

また、Rubyコアとstdlibのドキュメントなどの優れた例のソースがあります。例えば、からクラスのメソッドのいずれかを見てみましょうFileクラス：

File.atime（file_name）=>時間

指定されたファイルの最終アクセス時間をTimeオブジェクトとして返します）。

File.atime("testfile") #=> Wed Apr 09 08:51:48 CDT 2003

最初の行をクリックすると、RDocマークアップを含む元のソースコードを表示できます（この回答に含めた引用ではなく、実際のRDocページで）。この場合、メソッドはCで実装されましたが、RDocのフォーマットはRubyで実装された場合と同じです。

/*
 *  call-seq:
 *     File.atime(file_name)  =>  time
 *  
 *  Returns the last access time for the named file as a Time object).
 *     
 *     File.atime("testfile")   #=> Wed Apr 09 08:51:48 CDT 2003
 *     
 */

これからcall-seq:、メソッド名とパラメーターを選択したテキストに置き換えることができることがわかります。これは、クラスメソッドに非常に役立ちます。また、Markdownと同様に、サンプルコードをインデントして等幅フォントで表示する方法も示しています。

RubyForgeは廃止されたため、新しいリンクは次のとおりです。

http://ruby-doc.org/stdlib-2.5.1/libdoc/rdoc/rdoc/RDoc/Markup.html