section id="rd" xreflabel="RD"

RD je dokumentační formát pro psaní „vnořené dokumentace“, tedy dokumentace která je součástí zdrojového kódu. V RD píšeme čistý text obohacený o několik druhů značek. Jedná se vlastně o velmi jednoduchý značkovací jazyk.

Protože píšeme dokumentaci i program v jednom, musí nějak ruby i další programy rozlišit text od kódu. K tomuto jsou určeny značky

=begin
=end

Vše mezi nimi je považováno za dokumentaci.

Řádky začínající '---' jsou speciálním případem labeled list, kde label je název metody a signatura.