Rails includes several bits of custom markup (such as the new "cattr_*" methods). This plugin for YARD adds support for this custom markup, which otherwise is parsed incorrectly.
Charles H. Pence
gem "yard-rails", "~> 0.1.0"