用过word和postman写接口文档,感觉都有不满意的地方。大家都用什么写接口文档?
markdown + docsify 将就中,就是有点累
接口文档必须swagger啊,目前的规范
来自酷炫的 CNodeMD
swagger 最近好像要改名叫OpenAPI了
最后还是觉得postman最容易上手,而且可以方便地测试接口。各种需求均可实现。
之前一直用 apiary.io。Blueprint虽好但访问还是有点慢,而且和其他文档分散了。
琢磨了很久最后还是用 Markdown 手写最灵活。在 GitHub 的就写在 wiki 里,缺点是没有版本控制。