过去的方式:服务端提供 API 接口,一开始商定是写在 wiki 上的,有参数说明,返回结果的例子。当然有一些通用的,比如返回状态码、通用参数等等。
目前情况: 已经合作大约一年了,因为现在业务线比较多,然后直接告诉我不想写 wiki 文档了,目前状况人员稀缺、业务多,加上 wiki 写文档比较慢不好编辑,影响他开发进程,已来不及写了,给我一个诸如 postman 之类的让我先用用。
对于我而言:文档说明不能没有的,是我和其他人唯一参考的标准,不管怎么样,为了加快进程,开发过程中是可以有临时的其他方式,但文档一定要补上,以后排查问题总得有文档可以查阅吧。
来这里就想问问大家:
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.