私たちは最近、RAMLを使用して API を文書化することを決定しましたが、これまでのところすべてがうまくいっているようです。
raml2htmlユーティリティを使用して、静的な HTML ドキュメントを生成しています。デフォルトのテンプレートはうまく機能しますが、はるかに優れた API ページを見てきました。例/すぐに使用できるテンプレートのコレクションについて知っている人はいますか?
編集: RAML が進化するにつれて、その周りのツールも進化しています。最近、興味深いテーマを見つけました: https://github.com/wdullaer/raml2html-slate-theme