请问各位，公司内部的接口文档是怎么管理的？

2017-09-12 19:48:51 +08:00
 MrXiong
  1. 公司准备使用 swagger，基于注解的方式，但是发现多个项目无法集成，很不方便
  2. swagger-ui 中没有接口的搜索功能

请问各位还有啥比较好用的轮子？

18702 次点击
所在节点    Java
119 条回复
mahengyang
2017-09-13 13:56:00 +08:00
多个接口之间的关系怎么体现呢？
janus77
2017-09-13 14:00:09 +08:00
RAP 啊
luili
2017-09-13 14:02:37 +08:00
confluence
tjxiter
2017-09-13 14:08:48 +08:00
口口相传+1
darklh
2017-09-13 14:27:13 +08:00
前公司用 rap
zpf124
2017-09-13 14:29:49 +08:00
前段时间我们要补文档，找了半天最终用了 swagger。

话说当时还看到一个 Read The Docs 不知道有没有人用这个
acros
2017-09-13 14:34:11 +08:00
口口相传的各位····
兼职公司吟游诗人职位吗？
JustCJ
2017-09-13 14:45:34 +08:00
slate
MushishiXian
2017-09-13 15:14:21 +08:00
有时候更新了文档还是要去通知下,通知过程中可能就直接说改了哪里,也可能就是口口相传了,网易那个 nei 不知道怎样,体验了下感觉还行
v2chou
2017-09-13 15:15:06 +08:00
给你一个眼神,自己体会
zhouyou457
2017-09-13 15:20:30 +08:00
正常情况下写 md，然后导出 pdf 放 svn 上。。

紧急情况下，口口相传，记不清的自己看聊天记录[doge]
ming7435
2017-09-13 15:26:49 +08:00
@49degree RAP+1
xjmroot
2017-09-13 15:30:55 +08:00
showdoc 管理的，蛮方便
https://www.showdoc.cc/1666386?page_id=15335212
xjmroot
2017-09-13 15:32:40 +08:00
公司内部部署个，超级简单，还能导出 word
https://github.com/star7th/showdoc
teaaa
2017-09-13 15:36:45 +08:00
dokuwiki 也很好用啊 可以自动生成目录
Wysten
2017-09-13 15:36:59 +08:00
眼神体会
kk941kk
2017-09-13 15:43:53 +08:00
没有文档，不用管理。。
jadec0der
2017-09-13 16:37:12 +08:00
thrift / confluence ( http)
SvenWong
2017-09-13 16:41:04 +08:00
口口相传 +1
Hilong
2017-09-13 16:41:59 +08:00
300 多个接口，没有文档，就一个 postman 调用事例，然后口口相传

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/390148

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX