写一起:
优点: 好维护
缺点: 注解太多?
不写一起:
缺点: 不利于维护
理论上应该是文档先行，后写代码。大家都是如何做的？
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 2893 days ago, the information mentioned may be changed or developed.
 |
1
noNOno Nov 19, 2018  1
我个人,文档 /代码是写在一起.有项目规范,就遵从规范.
先写文档 /注解,留个空类 /空方法,然后再去实现. |
 |
2
CFO Nov 19, 2018 via Android
不好维护的文档有什么用？过期的 不能用的文档还不如没有 浪费大家调接口的时间
|
 |
3
luozic Nov 19, 2018 via iPhone
swagger codegen 系列
|
 |
4
suzic Nov 19, 2018 via Android
用 apidoc 写在注释里。重点是写接口的一定要理解产品需求，不然写出来前端也没法用
|
 |
5
TommyLemon Nov 19, 2018
分开好。
要写代码（注解、注释等）不只是增加开发工作量，还得重新部署才生效，后续维护也麻烦。 |
|
6
TommyLemon Nov 19, 2018
 |
|
7
TommyLemon Nov 19, 2018
一键自动接口回归测试，不需要写任何代码(注解、注释等全都不要)
|
|
8
TommyLemon Nov 19, 2018
|
|
9
TommyLemon Nov 19, 2018
 |
|
10
TommyLemon Nov 19, 2018
自动保存请求记录、自动生成接口文档
还有 自动生成封装请求 JSON 的 Android 与 iOS 代码 一键下载自动生成的 JavaBean 多个测试账号、一键共享测试用例 等 附 开放源码、视频教程 GitHub 右上角点 ⭐Star 支持下吧 ^_^ https://github.com/TommyLemon/APIJSONAuto |
Select Language