https://ruby-china.org/topics/32005

我想问下现在用什么 Gem 来生成文档比较好

https://github.com/richhollis/swagger-docs

apidoc 不错，简约，轻量

我倾向于不用这个，更喜欢 jbuilder，写起来看起来都像 json

jbuilder 风格更符合 rails，也足够灵活

也推荐使用 jbuilder , 使用起来方便、直观

jbuilder 和 Api Only 模式兼容吗

请教一下用过 AMS 的，我想要在返回的 Serializer 里面加一个状态，这样前端好处理些

{
     status: 200,
     user: {
        ...  
     }
}

就像这样，应该怎么写

这个 200 应该是 http code 吧，不需要在 response 里单独弄一个，如果要单独定一个 code，可是在 render json 时加个 meta 选项，只不过不是在返回数据的最外层有点别扭。 如果非要这样的话，还是 jbuilder 更方便点，ActiveSupport Serializer 感觉适用于高度 restful 的接口返回，并且针对一种 resource 不存在多种返回形态。