Документация — одна из самых важных составляющих любого проекта, особенно если этот проект с открытым кодом, который будут читать другие люди. Чтобы сделать мир opensource чуточку лучше, я попытался собрать свои знания в области организации модулей nodejs проектов и сделать такой инструмент как Makedoc!. Ремарка для адептов ruby: это почти то же, что и rdoc.info для руби.
Этот инструмент анализирует код проекта, выделяет потенциально документируемые куски кода (не важно, с документацией или без), и генерирует статический набор страничек, описывающих проект.
В кратце шаблон использования такой: идем на makedoc.node-js.ru/[githubusername]/[projectname] и видим готовую документацию по проекту. Либо идем на makedoc.node-js.ru/[githubusername] и получаем список проектов для которых можно сгенерировать документацию.
За деталями реализации прошу под кат.
Читать полностью »
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 научился брать документацию из комментариев:
Читать полностью »