Как правильно задокументировать метод в Objective C?
Такая возможность есть в новом Xcode 5. Для Xcode 4 — appledoc и doxygen.



В нем вообще много изменений — смотрите What’s New in Xcode 5 в списке видео с WWDC 2013
Как подсказывает Stackoverflow, Objective C не имеет встроенной возможности документирования. Как один из вариантов, на сайте разработчиков Apple показана работа с утилитой Doxygen, которая поможет составить удобную документацию.