api_documentation.md

What is the best way to document your API?

Links:

• http://swagger.io/redoc-openapi-powered-documentation/
• http://rebilly.github.io/ReDoc/
• https://github.com/Rebilly/ReDoc/
• https://github.com/lord/slate
• https://scotch.io/tutorials/speed-up-your-restful-api-development-in-node-js-with-swagger

Auto generate api docs in rails

• https://github.com/Apipie/apipie-rails
• http://stackoverflow.com/questions/973390/how-to-auto-generate-rails-rest-api-documentation-for-controllers
• https://blog.codeship.com/producing-documentation-for-your-rails-api/
• https://ilyabylich.svbtle.com/apipie-amazing-tool-for-documenting-your-rails-api
• https://forum.upcase.com/t/rest-api-documentation-tools/1850/6
• https://github.com/zipmark/rspec_api_documentation
• https://github.com/jejacks0n/apitome