Czy istnieje dobre, solidne odniesienie do prawidłowej składni RDoc?

Szukam dobrego, solidnego odniesienia do prawidłowej składni RDoc. Zalecenia? Nie mogę znaleźć niczego, co wyraźnie pokazuje:

1. Jak dokumentować metody klas i ich parametry
2. Jak udokumentować działanie klasy lub metody klas.

Oficjalny przykład rdoc można znaleźć tutaj , wraz ze źródłem GitHub .

Dokumentacja na rdoc.rubyforge.org wydaje się być bardziej kompletna niż wersja na rdoc.sourceforge.net (która notabene ma datę modyfikacji 2003).

Jest też świetne źródło przykładów: rdzeń Ruby i dokumentacja standardowej biblioteki. Na przykład spójrz na jedną z metod klasy z Fileklasy :

File.atime (file_name) => czas

Zwraca czas ostatniego dostępu do nazwanego pliku jako obiekt Time).

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

Możesz wyświetlić oryginalny kod źródłowy, w tym znaczniki RDoc, klikając pierwszą linię (na rzeczywistej stronie RDoc, a nie w cytacie, który zawarłem w tej odpowiedzi). W tym przypadku metoda została zaimplementowana w C, ale formatowanie RDoc jest takie samo, jak gdyby zostało zaimplementowane w Rubim:

/*
 *  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
 *     
 */

Z tego widać, że call-seq:pozwala zastąpić nazwę metody i parametry wybranym tekstem, co jest bardzo przydatne w przypadku metod klasowych. Pokazuje również, jak można wyświetlić przykładowy kod czcionką o stałej szerokości, wciskając ją, podobnie jak w przypadku Markdown.

Ponieważ RubyForge został wycofany , oto nowy link:

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