话说你司的 API 文档是如何进行管理的？

2017-04-13 10:19:07 +08:00
 ansheng

遇到一个尴尬的问题，我司 API 文档都是使用 markdown 来写的，然而是放在项目目录下面的 README.md 中，但是多人人多的时候修改起来就比较麻烦，就想用有没有一种在线的 API 文档管理程序撒的，石墨固然好，好像不支持 Markdown 所以没打算用。

哎。 Fuck

7725 次点击
所在节点    程序员
98 条回复
strongcoder
2017-04-13 16:30:46 +08:00
我司用 word 。。快被气死
Observer42
2017-04-13 16:38:03 +08:00
swagger
zoffy
2017-04-13 16:39:54 +08:00
@snriud #25 是这样的
subdued
2017-04-13 16:42:07 +08:00
我司 API 文档靠口口相传
guodont
2017-04-13 16:46:31 +08:00
swagger +1
apidoc +1
virusdefender
2017-04-13 16:50:57 +08:00
口口相传

心有灵犀
xxdd
2017-04-13 16:56:46 +08:00
口口相传

心有灵犀

(●'◡'●)ﾉ♥
prasanta
2017-04-13 17:02:46 +08:00
用 mkdocs+git
Ouyangan
2017-04-13 17:17:10 +08:00
swagger+1
qdpoboy
2017-04-13 17:36:00 +08:00
喊！呀
Wilon
2017-04-13 17:36:47 +08:00
@izoabr 上班着，要被你的答案笑死了，虽然我们也是口口相传
Vvfan
2017-04-13 17:37:11 +08:00
看来不止我们用 word /(ㄒoㄒ)/~~
kisnows
2017-04-13 17:54:17 +08:00
Word Wiki 有道云 + 口口相传
nextbox
2017-04-13 17:56:12 +08:00
RAP
imherer
2017-04-13 18:22:43 +08:00
https://github.com/lord/slate
ydq419453527
2017-04-13 18:29:33 +08:00
@zi @strongcoder @Vvfan txt 的默默路过 =。=
Blazings
2017-04-13 18:30:13 +08:00
口口相传牛逼
auhah
2017-04-13 18:31:49 +08:00
想起了前前前公司，我刚工作的时候

CTO 特别屌

自己撸了一套 API 网站

还以为是 IT 公司标配

后来几个公司 tmd 全是 word
mfu
2017-04-13 18:32:03 +08:00
写 WORD 里扔 SVN 上。 T_T
WhoMercy
2017-04-13 18:43:24 +08:00
遇到过 word 生成 html 扔内网服务器，给个固定网址的……

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

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

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

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

© 2021 V2EX