@zhout 同个模块下 controller 级别可以分组的，这个可以看官方文档有分组配置，当然不同用户可能对 API 的分组需求有些不同，很多场景用户不提 issue 我们可能没法覆盖到。我们和 swagger 有很多区别，我们目标给研发链提供更多的支持，所以支持多种接口协议的文档生成，性能测试脚本的生成。随之时间沉淀 smart-doc 在国内知名大厂用户反而更多了。

2024-06-12 13:48:12 +08:00

回复了 smartdoc647 创建的主题 › Java › smart-doc 3.0.5 发布，支持普通 Java 类文档的生成

@ByteCat 不支持 Kotlin ，确实有很多用户希望我们支持 Kotlin 和 golang 这些语言，但是社区没有足够精力支持。Java 开发 gradle 和 maven 都可以用。

2024-06-06 11:02:43 +08:00

回复了 bxb100 创建的主题 › Java › 关于 swagger 的疑惑

线设计 API 文档和工具并不冲突，比如我最近的开发方式：
1 、分析需求文档
2 、用自己开发的 SpringBoot 脚手架创建一个空的 SpringBoot 项目用于建模 API 接口
3 、思考需求，在 2 步骤创建的 API 建模项目中定义空结构体和空 Controller 接口
4 、用 smart-doc 扫描定义的空接口生成 API 文档
5 、用生成的 API 文档和前端和产品人员完成定稿和微调。
6 、启动正式项目开发，完全复制一些前面编写空接口的结构体。

2024-05-15 13:52:52 +08:00

回复了 rookie2luochao 创建的主题 › 程序员 › 做一个 Java 、 Python 、rust 版本的新 swagger-ui 包会有人用吗

@rookie2luochao 目前主要在国内仓库，torna 是因外一个社区的人开发的，我属于项目发起人，docker 镜像下载量 5 位数+级别的，https://gitee.com/durcframework/torna

2024-05-13 13:43:00 +08:00

回复了 rookie2luochao 创建的主题 › 程序员 › 做一个 Java 、 Python 、rust 版本的新 swagger-ui 包会有人用吗

@rookie2luochao yapi 不怎么维护，而且他的后台用 nodejs 开发的也不太符合现在很多公司的主流技术了，二次开发不行。所以我做 smart-doc 这个工具的时候发起了 torna ，torna 现在国内部署量还可以，但是受限于前端，目前社区也缺人力。

2024-05-13 11:29:27 +08:00

回复了 rookie2luochao 创建的主题 › 程序员 › 做一个 Java 、 Python 、rust 版本的新 swagger-ui 包会有人用吗

ui 这种还是适合小型组织，在大厂 ui 不怎么行的通。包括在应用里集成 swagger 也不太行，侵入性会被很多团队放弃，压法阶段基本上走下正常单元测试就可以，不需要什么界面去自测。成熟组织一般就是 yapi 和 torna 这种具备集成和管理的系统。

2024-04-02 15:13:22 +08:00

回复了 sunshai 创建的主题 › 程序员 › 咨询： Go 开发 api 管理工具

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

» smartdoc647 创建的更多回复