JSON API文档工具

Question

是否有工具或简单的方法来生成/维护丰富的RESTful JSON API文档？

我还希望发布和维护（作为可执行文档），类似relishapp提供的内容。 An example

该应用程序是Restful Ruby on Rails 3应用程序，使用黄瓜和R-Spec控制器测试进行测试。

Answer 1

你说你已经进行过Cucumber测试 - 他们 你的文档。他们可能只需要一些工作来阅读。

对于输出，您可以使用Cucumber的内置HTML格式化程序。