【投票】大家公司用什么做接口文档

小幺鸡+1，不好用+1

老实说，好几家公司了，没有过，全靠口口相传 😷

口口相传

用的 ApiFox

apipost

口口相传+1

yapi

用的 apifox

以前手写 md，后来用了一段时间 swagger，再后来就 apipost 了

swagger apifox word 都有 更有直接聊天记录

手写 md

有些有， 有些没有，Yapi， 然后飞书上也有 🤪， 弊端就是修改了参数，没人维护接口，导致货不对板，还不如没有
然后一些项目我用 Python 的 Swagger 注释 (docstrings)做了， 但是其他人不用，我也就做了一半， 现在大多是单人项目，也就相当于没有了。

python 用 fastapi 写接口的时候，按规范写得话，可以自动生成 Swagger 文档。
但是、但是、但是
我 TMD 的是运维，老 J8 让我写代码

apifox 或者 口口相传

apifox，但我一直担心他的数据安全性，就怕哪天丢了

小公司就 直接发消息，或者直接丢云文档过来。

swagger

让 AI 写 md 文档, 带上路由和收发参数示例, 文档纳入版本管理