You should be careful with YARD -- we've found a number of bugs in it that lead to broken/missing documentation. The ruby standard library, for example, is mis

You should be careful with YARD -- we've found a number of bugs in it that lead to broken/missing documentation. The ruby standard library, for example, is missing huge chunks of its documentation if you use YARD instead of RDoc. I very much wanted YARD to be a drop-in replacement for RDoc, but it's not quite there yet.