Описание для возврата просто ClassName?

Поместите документацию, где люди считают и запишут его, поскольку они используют и работают над кодом.

комментарии Класса идут перед классами, комментариями метода перед методами.

, Который является лучшим способом удостовериться, вещи сохраняются. Это также сохраняет Ваши заголовочные файлы, относительно склоняются, и избегает касание проблема людей, которых восстанавливают документы метода обновления, заставляющие заголовки быть грязными и инициирование. Я на самом деле знал, что люди используют это в качестве оправдания за запись документации позже!