eggjs 还不错

好像我没讲对。总是这两种方式只选择一种来用就是了。

这个好像是 axios 源码设计如此。后面有 then 和没有 then 返回的东西不一样。它是为了兼容 await 的写法和早前流行的 then 写法。你选择其中一个方式去做就好。不要两个一起来

showdoc 挺简单好用的，可以试下 github.com/star7th/showdoc

除非你有足够时间去做自我审查，随时盯着流量大访问量多的代理，一发现不良内容就封杀

你这个服务肯定做不大的啊。不是一开始就应该考虑风险控制吗。你完全控制不了用户会代理什么内容，对内容审查失去了控制能力，这早晚会被封的。撑久一点也还是会被封的，这种命运在国情下活不了。你再怎么坚持，也不过是成为非法内容的温床而已。建议你换个方向做，或者考虑用个国外 vps。

@vsheyan 会被质疑的。这篇的质疑少一些是因为确实有很多干货。如果再发一篇就不合适了。另外我觉得，很多 markdown 类开源项目因为收集了一些教程 /资源而获得了高关注。这让我们这些实打实做代码开源的项目黯然失色。现在我尽量让自己的项目获取多一点的关注，都被小部分人质疑。长此以往，劣币驱逐良币，做开发类的开源项目更难了。

@encro 我在这里回答一下你吧。首先你们要考虑使用在线服务还是内网部署服务。如果是内网部署服务，你基本不能再考虑 tapd/语雀 /EOLINKER 等。这些要么不能内网部署要么部署成本太高，不如免费开源的 showdoc。
如果你不介意要不要内网部署。那么——
首先你要做的是知识管理，不单单是程序员使用，也不单单是管理 api，所以像 EOLINKER 之类的也不太适合你。这类产品专业性比较强，基本只适合管理 api。
tapd 我不知道外网版的如何，我只在腾讯时候使用过内网版。我觉得 tapd 在项目管理上很强大，但是 wiki 功能比较弱（这个工具一开始就把 wiki 定位为辅助性工具）。如果要做专门的知识管理，不是很建议。
传统的 wik 功能比较强大，但是界面一般，用户体验一般，我个人是很不习惯用的。
语雀是一个不错的产品。但它为了照顾更大群体使用者，引入了一些需要额外理解的概念，比如企业空间，以及其他。在应付中大型复杂组织可能会适用一些。只是对新手可能要花点时间去理解。showdoc 定位于简单好用，可以管 api 可以写知识文档，非常适合扁平化的 IT 团队，把易用性和性价比发挥得不错。
这是我个人的选择建议。

@encro 你说你发布的那个主题我访问不了，我不知道你发到哪个节点去了。
我访问不了是因为没绑定手机。v2 我一直 github 账户登录，还没绑定手机。而当绑定手机，它提示我要原密码，而原密码我又忘记了，所以不折腾了，就没绑定手机。

@lower 现在 runapi 做在线测试其实还可以。可以用那个。

@encro 我不贬低他人。我一般只说 showdoc 哪里好，不通过比较来说别人坏。我既然坚持做 showdoc，自然心里会有自己的想法，并且觉得 showdoc 依然有它的优势。如果你想讨论，你可以另外开贴，我会去回帖一下。但我就以自己的名义开贴公开讨论了，免得别人说我贬低他人作品。

@Simle100
@npe
使用 showdoc 也可以自动生成 api 文档，不一定需要人工写。创建项目的时候可以看到 showdoc 自动化生成 api 文档的说明

@outside
@onfuns
showdoc 和 rap2 走的是不同的路线。showdoc 更像一个文档工具，不单纯为 api 而生，还可以支持数据字段，团队文档资料等。扩展性会强一些。而 rap2 在 api 测试方面的专业性强一些。

@test3207 你说的这几点在新版都解决了啦。比如说可以一并删除一个目录和目录下的页面；目录排序和文档排序都改用了拖放方式。文档删除一开始只做标记，但是会定时清理的。这个是当初埋下的隐藏功能。现在已经把这个功能扩展为回收站功能。

@memedahui 这个设计我是经过考虑的。首先，这些按钮在鼠标放上去的时候都即时地显示出文字，可以很好地引导用户。而当用户用习惯了，那么就差不多记得这些按钮地用途了。这个时候还展示文字的话，反而占据了视觉空间，显得不够简洁。

@sniperking1234 我复制一下前面的话。做事情需要共赢思维。如果说一个人花精力去写的东西完全没反馈，会打击分享热情的。最好的方式是大家共赢，你看了，对你有所启发有所帮助，对我而言有足够的反馈动力。

而且我不单纯想看到别人的肯定，我也想探讨一些问题。比如说我上面有哪些创作方式是可以改善的，更加有效运作的。像前面有人提到 Windows Subsystem for Linux，这就是我想看到的互动。

@jackchao7432 做事情需要共赢思维。如果说一个人花精力去写的东西完全没反馈，会打击分享热情的。最好的方式是大家共赢，你看了，对你有所启发有所帮助，对我而言有足够的反馈动力。

@noqwerty 我没有比较。主要是我几年前用 vagrant 的时候还没有 Windows Subsystem for Linux，所以不评价它。现在我是沿用之前的开发习惯继续用 vagrant。假如说 Windows Subsystem for Linux 挺好，也可以用的