Documenting with YARD
Rubydoc.info uses YARD to
generate all the documentation you see on the site. YARD is a
replacement to RDoc, the classic documentation system, but adds
many formatting and extensibility features that can make your life
easier! YARD is, for the most part, backwards compatible with RDoc
formatting. YARD, however, does not support directives such as
:nodoc:, but there are alternatives (see the "Where is
my :nodoc:?" article).
A good overview of the features added by YARD can be found in its README. Once you look over the basics, you will want to look at some examples of the formatting, which can be found in the Getting Started Guide.
Setting up a .yardopts file - Teaches you how to add extra options (or files) when generating documentation for your code.