Как вы документируете директивы AngularJS?

Существуют ли какие-либо специальные стандарты или инструменты для документирования директив AngularJS? Мы явно строим куски многоразовой функциональности, поэтому мы должны иметь возможность подключаться к разработчикам. Я видел пару вещей:

  • Кураж. Мне нравится направление Swagger 2.0, но неясно, как он будет использоваться для документирования директив.
  • Ngdoc (https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation) Это имеет то преимущество, что он тот же инструмент, что и команда AngularJS.

Есть ли какой-нибудь лучший метод, который люди нашли?

Ответ 1

Посмотрите на источник angular, в комментариях есть то, что используется для создания документации на angular сайте

аналогичный подход используется в этом плагине: https://github.com/Vertafore/grunt-docular

что мы используем, где я работаю