Làm thế nào để bạn tài liệu hướng dẫn AngularJS?

Question

Có bất kỳ tiêu chuẩn hoặc công cụ đặc biệt nào để ghi lại các chỉ thị AngularJS không? Chúng tôi đang xây dựng một cách rõ ràng các chức năng có thể sử dụng lại, vì vậy chúng tôi có thể có được giao diện của họ cho các nhà phát triển. Tôi đã thấy một vài điều:

• Chuyển đổi. Tôi thích hướng Swagger 2.0 đang diễn ra, nhưng không rõ nó sẽ được sử dụng như thế nào để ghi lại các chỉ thị.
• Ngdoc (https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation) Điều này có lợi thế là cùng một công cụ mà nhóm AngularJS sử dụng.

Có một số phương pháp tốt hơn mà mọi người tìm thấy không?

Answer 1

Có một cái nhìn tại nguồn góc của, các ý kiến ​​có gì được sử dụng để tạo ra các tài liệu trên trang web của góc

một cách tiếp cận tương tự được sử dụng trong plugin khó khăn này: https://github.com/Vertafore/grunt-docular

đó là những gì chúng tôi sử dụng ở đâu Tôi làm việc