Я только начал документировать приложение rails. Я знаю, что это действительно сделано rdoc, поэтому я следил за некоторыми руководствами rdoc относительно синтаксиса и т.д., Но я застрял, когда пытался описать атрибуты моделей, валидации и отношения между моделями, главным образом потому, что эти вещи являются частью ActiveRecord. Поэтому я задаюсь вопросом, есть ли какое-нибудь руководство или хорошая практика относительно того, как документировать приложение для рельсов, или если что-то мне не хватает?
Я знаю, что могу описать все это в описании класса, но мне интересно, есть ли способ, более тесно связанный с самим объявлением (has_many, validates_presence_of и т.д.), и как насчет атрибутов?