大家有用 Swagger 编写文档吗？我打算做一套 Swagger API 的云端撰写工具。

先放链接： https://run27017.tk/swaggerhuge

这是我做的一个 Swagger 文档云端撰写工具，目前实现的功能有：

• 支持组织，文档对外是私有的，在组织内是开放的

目前实现的较为简陋，主要是看大家有没有使用 swagger 协作编写文档的需求。如果没有这方面的需求的话，我就仅仅作为自己团队能够使用的效果就好了。如果还是有这个需求的，我就进一步地完善它，加入我本就打算加入的几个核心关键功能。

目前来说，撰写文档主要有三种方式：

1. 使用内嵌注释或者 DSL，然后工具生成
2. 使用在线的文档撰写工具，如 swaggerhub
3. 使用可视化的文档在线工具，如阿里的 RAP

就我个人来说，我的倾向顺序是 1,2,3. 有些人可能觉得可视化的东西很好，我还是不很习惯。