我有一个 API only rails 应用程序,它需要前端开发人员的文档。这是我第一次体验它。
您为此目的使用什么工具?请注意,我使用的是 rails 5 API 而不是 Grape。
我测试了Apipie
,swagger-blocks
和swagger-docs
gems,但它们已经过时或有问题。一定有更好的选择!
尊重任何建议
我有一个 API only rails 应用程序,它需要前端开发人员的文档。这是我第一次体验它。
您为此目的使用什么工具?请注意,我使用的是 rails 5 API 而不是 Grape。
我测试了Apipie
,swagger-blocks
和swagger-docs
gems,但它们已经过时或有问题。一定有更好的选择!
尊重任何建议
好吧,我发现Slate是最好的之一。
您是否尝试过 RSpec Api 文档?https://github.com/zipmark/rspec_api_documentation
这里有一篇关于将其与 codeship 一起使用的文章:https ://blog.codeship.com/produce-documentation-for-your-rails-api/