先放链接: https://run27017.tk/swaggerhuge
这是我做的一个 Swagger 文档云端撰写工具,目前实现的功能有:
- 支持组织,文档对外是私有的,在组织内是开放的
目前实现的较为简陋,主要是看大家有没有使用 swagger 协作编写文档的需求。如果没有这方面的需求的话,我就仅仅作为自己团队能够使用的效果就好了。如果还是有这个需求的,我就进一步地完善它,加入我本就打算加入的几个核心关键功能。
目前来说,撰写文档主要有三种方式:
- 使用内嵌注释或者 DSL,然后工具生成
- 使用在线的文档撰写工具,如 swaggerhub
- 使用可视化的文档在线工具,如阿里的 RAP
就我个人来说,我的倾向顺序是 1,2,3. 有些人可能觉得可视化的东西很好,我还是不很习惯。