Tool for JSON API Documentation [closed]

Closed. This qu开发者_如何学Cestion is seeking recommendations for books, tools, software libraries, and more. It does not meet Stack Overflow guidelines. It is not currently accepting answers.

---

We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.

Closed 5 years ago.

Improve this question

Is there a tool or an easy way to generate/maintain documentation of a rich RESTful JSON API?

I also would want to publish and maintain (as executable documentation) it, something like what relishapp provides. An example.

The application is Restful Ruby on Rails 3 application, tested using cucumber and R-Spec controller tests.

---

You say you have Cucumber tests already - they are your documentation. They may just need some work to be readable.

For output, you can use Cucumber's built-in HTML formatter.