smartdoc647

go 语言做 web 开发，api 管理工具不是最重要的，生成 API 文档的过程很烦，go swagger 页要求程序员写一堆的注释。
我自己是 java 文档生成工具 smart-doc 的作者。目前也只一个主力 go 语言的应用开发者。管理工具其实已经很多了，针对 go 语言文档生成端非常的弱

@xgfan 你可以理解为就是一种宣传和社区运营，让更多人来一起参与贡献，至于礼物多少价值真正参与开源的人并不在乎这些，所以也并不怕被喷。我们也是真正的做开源，项目在国内用户也很多，我们问心无愧。

@dianso 不能用物品价值去衡量开源社区奖品，奖品对于贡献者是鼓励和纪念意义。大多数开源社区本质是没有任何商业盈利的，也没有谁规定必须任何社区要给 Committer 发奖品，社区大多数的奖品也是文化衫或者是技术相关的图书。
我们非常尊重行业每一个真正的开源技术社区和无数的开源贡献者。

@musi 这个只是个宣传，目前也没有专业的社区运营人员，没什么尬的，至少我们也是国内极少数真实的给了贡献者一些小奖励的开源社区。也是为了鼓励更多人参与开源社区的贡献。

@Philippa swagger 对群主框架就没啥用的，go 框架也能用 swagger 搞，但是我们发现这东西无脑让写一堆非标注释。理想的情况就是既不去影响用户的代码，又不能要求用户写一堆非标注释增加开发的负担。smart-doc 在国内在 java 领域非常受欢迎也是这个原因。我们的贡献者甚至都有小米、快手这些公司的。

无注解框架的有一个痛点就是搞接口文档比较难，其实很多开发都不想手写文档，像我们开源的 smart-doc 对 spring 这种注解路由的框架，工程师已经只需要写几行简单的 javadoc 注释了。生成的文档质量也远超手写的。我同时也是一个 golang 开发者，我们发现 go 的框架基本也是声明式路由，搞文档就很头痛