https://ruby-china.org/run27017 en-us <p>不知道大家会不会用 swagger 生成 Restful 的 API 文档，反正我是写了一个云端的 Swagger 撰写工具，它支持：</p> <ol> <li>API 的私有性，对项目组外不可见</li> <li>支持多人编写同一个文档的自动合并和冲突报警</li> <li>编写超过一万行的文档不卡顿</li> </ol> <p><strong>本行放工具链接： <a href="https://run27017.tk/swaggerhuge" rel="nofollow" target="_blank" title="">SwaggerHuge</a></strong></p> <p>另外，我认为，撰写文档主要有三种方式：</p> <ol> <li>使用内嵌注释或者 DSL，然后工具生成</li> <li>使用在线的文档撰写工具，如 swaggerhub</li> <li>使用可视化的文档在线工具，如阿里的 RAP</li> </ol> <p>就我个人来说，我的倾向顺序是 1,2,3. 有些人可能觉得可视化的东西很好，我并不是很习惯。</p> <p>最后，希望大家多提点意见，热切欢迎各种交流。我的邮箱是 run27017@126.com</p> run27017 Thu, 26 Apr 2018 15:12:36 +0800 https://ruby-china.org/topics/36068 https://ruby-china.org/topics/36068