На StackOverflow был отличный пост точно на эту тему, но какой-то сверхусердный модератор, который должен остаться неназванным, удалил его (судя по всему, сейчас восстановлено — прим. пер.).
К счастью, у меня сохранилась возможность просмотреть все удаленные комментарии. Вот некоторые из моих любимых.
//
// Дорогой мейнтейнер:
//
// Когда ты закончишь «оптимизировать» эту подпрограмму
// и поймешь, насколько большой ошибкой было делать это,
// пожалуйста, увеличь счетчик внизу как предупреждение
// для следующего парня:
//
// total_hours_wasted_here = 42
//
Quick Help для своего кода в XCode 5
2013-09-03 в 3:55, admin, рубрики: comments, documentation, doxygen, iOS, mac os x, objective-c, xcode, документирование, комментарии, разработка под iOS, метки: comments, documentation, doxygen, iOS, mac os x, objective-c, xcode, документирование, комментарииQuick Help научился брать документацию из комментариев:
Читать полностью »