Τα RDoc και YARD είναι βασικά εργαλεία τεκμηρίωσης για τη Ruby, δημιουργώντας τεκμηρίωση API από σχόλια κώδικα.
Πρότυπο τεκμηρίωσης μεθόδων
# Calculates total order price after applying discount vouchers.
#
# @example Applying a seasonal voucher
# calculator = PriceCalculator.new(order)
# calculator.final_total(voucher: 'SUMMER20') #=> 80.0
#
# @param voucher [String, nil] The voucher code to apply.
# @param tax_rate [Float] Applicable sales tax rate (default: 0.1).
# @return [Float] Total rounded price in USD.
# @raise [InvalidVoucherError] If voucher is expired or unrecognized.
def final_total(voucher: nil, tax_rate: 0.1)
# ...
end
Μορφοποίηση Inline Markup
*bold text*
_emphasized text_
+code or monospace+
{ClassName} # Σύνδεσμος προς κλάση
{ClassName#method} # Σύνδεσμος προς μέθοδο στιγμιοτύπου
{ClassName.method} # Σύνδεσμος προς μέθοδο κλάσης
Ειδικές οδηγίες (Directives)
# Απόκρυψη μεθόδου ή κλάσης από την παραγόμενη τεκμηρίωση
def internal_secret # :nodoc:
end
# Τεκμηρίωση συγκεκριμένης υπογραφής κλήσης
# :call-seq:
# format(val) -> String
# format(val, options) -> String