7、在线接口文档沟通

项目场景:

新增多个接口,但是用离线版的word文档,进行沟通,如果对接口内容有更改,就会导致频繁的发送文档


问题描述

新增多个接口,但是用离线版的word文档,进行沟通,如果对接口内容有更改,就会导致频繁的发送文档


原因分析:

看项目要求,如果是研发者使用,可能会使用一些在线文档,但是大部分都是需要离线文档,进行存档的


解决方案:

  1. 找一个在线文档
  2. 每次有修改,都告诉对方
  3. 如果涉及主键,外键等等这些,不要只截图,有时候截图会不全
  4. 双方的研发者都需要多沟通
  5. 多沟通,准没有错
  6. 可以讲解业务场景,或者接收数据之后,应该怎么做
  7. 最终拍板是对方,不是你
相关推荐
云烟成雨TD20 小时前
Spring AI Alibaba 1.x 系列【6】ReactAgent 同步执行 & 流式执行
java·人工智能·spring
于慨20 小时前
Lambda 表达式、方法引用(Method Reference)语法
java·前端·servlet
swg32132120 小时前
Spring Boot 3.X Oauth2 认证服务与资源服务
java·spring boot·后端
gelald20 小时前
SpringBoot - 自动配置原理
java·spring boot·后端
殷紫川20 小时前
深入理解 AQS:从架构到实现,解锁 Java 并发编程的核心密钥
java
一轮弯弯的明月20 小时前
贝尔数求集合划分方案总数
java·笔记·蓝桥杯·学习心得
chenjingming66620 小时前
jmeter线程组设置以及串行和并行设置
java·开发语言·jmeter
殷紫川21 小时前
深入拆解 Java volatile:从内存屏障到无锁编程的实战指南
java
eddieHoo21 小时前
查看 Tomcat 的堆内存参数
java·tomcat
那个失眠的夜21 小时前
Mybatis延迟加载策略
xml·java·数据库·maven·mybatis