你如何记录AngularJS指令？

Question

是否有用于记录AngularJS指令的临时标准或工具？我们明确地构建了可重用的功能，因此我们应该能够将它们的接口交给开发人员。我见过几件事：

• 扬鞭。我喜欢Swagger 2.0的发展方向，但目前尚不清楚它将如何用于记录指令。
• Ngdoc（https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation）这样做的好处是它与AngularJS团队使用的工具相同。

人们找到了一些更好的方法吗？

Answer 1

看一下angular的来源，那里的注释用于生成角度网站上的文档

在这个grunt插件中使用了类似的方法：https://github.com/Vertafore/grunt-docular

这是我们工作的地方