Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

API Documentation tool for Rails 5 [closed]

I have an API only rails app which needs documentation for frontend developers. And it's my first experience with it.

What tool do you use for this purpose? Note that I am using rails 5 API and not Grape.

I tested Apipie, swagger-blocks, and swagger-docs gems, but they are obsolete or buggy. There must be a better option!
Any recommendations respected

like image 947
MalekMFS Avatar asked Feb 09 '18 07:02

MalekMFS


People also ask

What is Apipie?

Apipie-rails is a DSL and Rails engine for documenting you RESTful API. Instead of traditional use of #comments, Apipie lets you "describe the code by code". This brings advantages like: It uses ruby syntax. Reusable doc for other purposes (Best for validations)

What is REST API in Rails?

REST stands for REpresentational State Transfer and describes resources (in our case URLs) on which we can perform actions. CRUD , which stands for Create, Read, Update, Delete, are the actions that we perform. Although, in Rails, REST and CRUD are bestest buddies, the two can work fine on their own.


1 Answers

Well, I found Slate one of the best out there.

like image 89
MalekMFS Avatar answered Oct 29 '22 22:10

MalekMFS