Документацию к классу пишут перед объявлением класса. Читай стандарт [yard](https://github.com/lsegal/yard)