Ответ 1
Посмотрите на источник angular, в комментариях есть то, что используется для создания документации на angular сайте
аналогичный подход используется в этом плагине: https://github.com/Vertafore/grunt-docular
что мы используем, где я работаю
Как вы документируете директивы AngularJS?
Существуют ли какие-либо специальные стандарты или инструменты для документирования директив AngularJS? Мы явно строим куски многоразовой функциональности, поэтому мы должны иметь возможность подключаться к разработчикам. Я видел пару вещей:
- Кураж. Мне нравится направление Swagger 2.0, но неясно, как он будет использоваться для документирования директив.
- Ngdoc (https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation) Это имеет то преимущество, что он тот же инструмент, что и команда AngularJS.
Есть ли какой-нибудь лучший метод, который люди нашли?