Документация кода Xcode

Существуют ли какие-либо рекомендации / стандарты о том, как документировать код, написанный на XCode? Я имею в виду, есть ли способ задокументировать код, если вы хотите, чтобы он был легко понятен другим? Предоставляет ли XCode инструмент, который можно использовать для автоматического создания документации, такой как справочные документы API из вашего кода + комментарии?

По крайней мере, мне интересно понять, существует ли стандартный способ написания комментариев перед интерфейсами / протоколами / методами определено в вашем коде. Я видел директивы using, подобные следующей, но не понимал, как они работают:

#pragma mark -
#pragma mark Initialization
9
задан Mogsdad 28 December 2017 в 15:28
поделиться