smartdoc647 最近的时间轴更新
smartdoc647

smartdoc647

V2EX 第 445380 号会员,加入于 2019-10-09 14:08:01 +08:00
smart-doc开源项目作者,torna项目发起人。
阿里ilogtail项目committer
smartdoc647 最近回复了
@ByteCat 不支持 Kotlin ,确实有很多用户希望我们支持 Kotlin 和 golang 这些语言,但是社区没有足够精力支持。Java 开发 gradle 和 maven 都可以用。
10 天前
回复了 bxb100 创建的主题 Java 关于 swagger 的疑惑
线设计 API 文档和工具并不冲突,比如我最近的开发方式:
1 、分析需求文档
2 、用自己开发的 SpringBoot 脚手架创建一个空的 SpringBoot 项目用于建模 API 接口
3 、思考需求,在 2 步骤创建的 API 建模项目中定义空结构体和空 Controller 接口
4 、用 smart-doc 扫描定义的空接口生成 API 文档
5 、用生成的 API 文档和前端和产品人员完成定稿和微调。
6 、启动正式项目开发,完全复制一些前面编写空接口的结构体。
@rookie2luochao 目前主要在国内仓库,torna 是因外一个社区的人开发的,我属于项目发起人,docker 镜像下载量 5 位数+级别的,https://gitee.com/durcframework/torna
@rookie2luochao yapi 不怎么维护,而且他的后台用 nodejs 开发的也不太符合现在很多公司的主流技术了,二次开发不行。所以我做 smart-doc 这个工具的时候发起了 torna ,torna 现在国内部署量还可以,但是受限于前端,目前社区也缺人力。
ui 这种还是适合小型组织,在大厂 ui 不怎么行的通。包括在应用里集成 swagger 也不太行, 侵入性会被很多团队放弃, 压法阶段基本上走下正常单元测试就可以, 不需要什么界面去自测。成熟组织一般就是 yapi 和 torna 这种具备集成和管理的系统。
74 天前
回复了 loyth06 创建的主题 程序员 咨询: Go 开发 api 管理工具
go 语言做 web 开发,api 管理工具不是最重要的,生成 API 文档的过程很烦,go swagger 页要求程序员写一堆的注释。
我自己是 java 文档生成工具 smart-doc 的作者。目前也只一个主力 go 语言的应用开发者。管理工具其实已经很多了,针对 go 语言文档生成端非常的弱
@xgfan 你可以理解为就是一种宣传和社区运营,让更多人来一起参与贡献,至于礼物多少价值真正参与开源的人并不在乎这些,所以也并不怕被喷。我们也是真正的做开源,项目在国内用户也很多,我们问心无愧。
@dianso 不能用物品价值去衡量开源社区奖品,奖品对于贡献者是鼓励和纪念意义。大多数开源社区本质是没有任何商业盈利的,也没有谁规定必须任何社区要给 Committer 发奖品,社区大多数的奖品也是文化衫或者是技术相关的图书。
我们非常尊重行业每一个真正的开源技术社区和无数的开源贡献者。
@musi 这个只是个宣传,目前也没有专业的社区运营人员,没什么尬的,至少我们也是国内极少数真实的给了贡献者一些小奖励的开源社区。也是为了鼓励更多人参与开源社区的贡献。
@Philippa swagger 对群主框架就没啥用的,go 框架也能用 swagger 搞,但是我们发现这东西无脑让写一堆非标注释。理想的情况就是既不去影响用户的代码,又不能要求用户写一堆非标注释增加开发的负担。smart-doc 在国内在 java 领域非常受欢迎也是这个原因。我们的贡献者甚至都有小米、快手这些公司的。
关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2402 人在线   最高记录 6679   ·     Select Language
创意工作者们的社区
World is powered by solitude
VERSION: 3.9.8.5 · 22ms · UTC 05:29 · PVG 13:29 · LAX 22:29 · JFK 01:29
Developed with CodeLauncher
♥ Do have faith in what you're doing.