TomDoc - Reasonable Ruby Documentation

1 · Tom Preston-Werner · May 11, 2010, midnight
TomDoc - Reasonable Ruby Documentation 11 May 2016 - San Francisco RDoc is an abomination. It’s ugly to read in plain text, requires the use of the inane :nodoc: tag to prevent private method documentation from showing up in final rendering, and does nothing to encourage complete or unambiguous documentation of classes, methods, or parameters. YARD is much better but goes too far in the other direction (and still doesn’t look good in plain text). Providing an explicit way to specify parameters a...