Document private web API
We set up a web API for project internal usage.
I'm looking for a nice way to document our API. I've searched the web and found

 - [IO Docs][1]
 - [Swagger][2]

These tools read in JSON files that can be created automatically, e.g. for Java. Our API has grown and I like to create the JSON manually, but not by hand in a text editor. Is there a tool or frontend that eases the burden of creating the descriptive JSON manually?

On the other hand, what are recommendable tools for the documentation of a web API?

  [1]: https://github.com/mashery/iodocs/
  [2]: http://swagger.wordnik.com/
Document private web API
===

We set up a web API for project internal usage.
I'm looking for a nice way to document our API. I've searched the web and found

 - [IO Docs][1]
 - [Swagger][2]

These tools read in JSON files that can be created automatically, e.g. for Java. Our API has grown and I like to create the JSON manually, but not by hand in a text editor. Is there a tool or frontend that eases the burden of creating the descriptive JSON manually?

On the other hand, what are recommendable tools for the documentation of a web API?

  [1]: https://github.com/mashery/iodocs/
  [2]: http://swagger.wordnik.com/