一个非常适合 IT 团队的在线 API 文档、技术文档工具 github.com/star7th/showdoc

懂点小技巧的人往往有一种自信，觉得自己可以裸奔能解决病毒问题。然而现在专业化的发展，互联网的安全不是一个普通安全爱好者就驾驭得了的。要敬畏一下这么多年来安全技术的发展。起码装个基本防护吧。哪个厂商的杀毒软件的基本防护能力都比 1000 个外行强。

@applelove 暂时还没。以后有空探索下

我觉得你的方向不太对。你的经验不能说明”不要做 CTO，不要做合伙人“ 。 而是，应该警醒后来者在一开始就明算账。 要占有够量的股份机制，以至于你遇到被创始人孤立的情况也不会太被动。其次就是把控技术核心。 身为 CTO 都把控不了技术核心，太容易被替代的话，则会很被动。

@deletemyself 其实 array 类型也算是 object 类型里面的。至少对 js 来讲，array 也是一种 object 。可能不同语言的定义有些许差别。预览功能可能是要看看想想。runapi 和 showdoc 使用的技术栈不一样，要共享预览样式不容易。同时，会不会用久了就习惯了，知道生成的都是一个模板都是那个样，就不需要预览了。这个得再收集下用户需求。

@deletemyself 还有哪些字段类型没覆盖到的？预览文档这块的话，考虑下怎么做。

@ipadpro4k 不放心使用线上服务的话自己使用开源版搭建吧 github.com/star7th/showdoc

@ipadpro4k showdoc.cc 这个域名是四年前注册的，那时候是可备案的。现在新的 cc 域名就不可以备案了。我目前已经注册了 showdoc.top , .co .work 域名用来备份。com 域名的话，没办法，拿不到 showdoc 域名。

@zpfhbyx 嗯，get 参数是要禁用 form 方式。其实你禁用不禁用对功能上没有影响，就是体验上要隐藏。
响应结果要分开 tab 才行，因为调试过程中可能有多次临时调试结果，不能直接作为文档。目前在切换 tab 这方面，有提供了小工具给用户一键复制过去，也能一键生成参数描述。不算很麻烦吧。

@zpfhbyx 可以多说点具体的建议来完善下

@shoaly
@wzq001 当前这个版本功能还不够完善，专业度还是远远比不上 postman 之类的，后面还要优化。但当前最主要的目的是解决文档的自动生成问题，同时尽量做得简单易上手。有问题可以随时反馈。

你们真的用过 eggjs 了吗？谈不上最好但好歹在国内还算可以吧。那个作者也挺热心的，一直在维护。说是纯 kpi 产物的你们够了。
国内有几个好的 js 框架呢。我觉得，它虽然没到顶尖水平，但若作为一个开源项目来看，文档写得完善，很多场景也有相应解决方案，这是已经比大部分开源项目好了的。不要因为人家比不上世界顶尖水平的框架就觉得人家差。

@Tigerw 另外这是个纯开源免费的工具 github.com/star7th/showdoc

@Tigerw 没必要为了差异而差异，产品怎么好用就怎么来做。关于 Showdoc 的详细介绍，请看：www.showdoc.cc/help

我一直都习惯用邮件收通知，所以写了个类似工具开放出去 www.v2ex.com/t/651215 不过看来用邮箱来做常用通讯手段的人还是少。

我还真的是这么做的，不觉得有什么问题。我在 showdoc 的实现排序机制有两种，github.com/star7th/showdoc ，一种是用户操作后，就把目录 /页面的数字排序都更新一遍。一种是项目排序，简单地保存整个数组，然后读取的时候，在代码里根据这个数组进行重排。目前没遇到啥问题。你上面考虑的性能问题，算法问题，我觉得是多虑了的。不会有那么多人并发操作，也不会 update 得特别慢。就这么简单处理就好。

个人觉得这个没毛病，人家无过错。我觉得，一般情况下，开源项目被拿去讲课有利于开源项目的推广。不过好像你这个项目也是偏向于教学，跟一般性的代码开源项目不一样。建议用一下别的开源许可证吧。

@learningman 就是拉多一个开源贡献者写代码的意思

@learningman 白嫖 ， 哈哈