4

API ドキュメントを自動生成する既存のツールがありますが、そのほとんどは REST サービス用に設計されたものではありません。

ServiceStack を使用して REST サービスを作成したすべての人にとって、どのようにドキュメントを作成しましたか? マニュアル/セミオート/フルオート発電? auto gen をカスタマイズされた WADL にして、それを apigee Console To Goのようなものに接続することも検討しています

(ああ、RESTafaries-「REST APIは自動検出可能で自己説明型でなければならない」というマントラを惜しまないでください...ユーザーのために見栄えの良いドキュメントが本当に欲しいです)。

4

1 に答える 1

1

XHTML を使用して API を文書化すると、DTO をフォーマットするよりも良い結果が得られる場合があります。http://www.amundsen.com/blog/archives/1043とこの感動的なビデオをご覧ください。

于 2012-08-27T20:24:23.723 に答える