RAMLで既存のAPIサービスを文書化するにはどうすればよいですか？

Question

私たちには現在かなり完成したプロジェクトがあり、何百もの既存のWEB APIサービスがあります。 私たちは、私たちが行ったように、すべてのものをwikiのデザインとサンプルURLまで記録しました。

私たちは終わりに近づいたので、API BlueprintやSwaggerのようなWEB APIサービスをより真剣に記述するための製品を見つけることができました。 私は、WikiのAPIサービスをAPI BlueprintとApiaryに移行しました。

しかし、このエディタはちょっと大変ですが、今はRAMLに遭遇しましたが、人間が読める構文と同様に再利用性の機能もあります。

しかし、2番目の目標は、同じAPIドキュメントを使用して統合テストを実行できるようにすることです。

手動ですべてを移動する必要なく私たちのサービスを自動的に文書化できるツールを知っている人はいますか？私は、統合テストもサポートするような環境が必要です。

Answer 1

言語によって異なります。あなたはあなたが言語や種類によって、利用可能なすべてのツールhereやフィルタを確認することができますRAML .NET Tools

を持つASP.NET 5/WEBAPIについては

。