先来介绍分别介绍下 smart-doc 和 Torna
smart-doc 是一款同时支持 JAVA REST API 和 Apache Dubbo RPC 接口文档生成的工具，smart-doc 在业内率先提出基于 JAVA 泛型定义推导的理念， 完全基于接口源码来分析生成接口文档，不采用任何注解侵入到业务代码中。你只需要按照 java-doc 标准编写注释，smart-doc 就能帮你生成一个简易明了的 Markdown 、Postman Collection2.0+、OpenAPI 3.0+的文档。除此之外 smart-doc 还支持生成漂亮简洁可调试的 html5 页面文档。
smart-doc 目前的国内知名的企业科大讯飞、小米、中国移动中都有一些研发团队在用，中小型公司就比较多了，码云的 star 数 1.2K(无任何水分的 star)。smart-doc 获得 2020 年度 OSC 中国开源项目评选「最积极运营项目」 奖。
2021 年 3 月在码云平台新开源的企业级接口文档管理平台。目标是让文档管理变得更加方便、快捷。Torna 采用团队协作的方式管理和维护项目 API 文档，将不同形式的文档纳入进来，形成一个统一的维护方式。
smart-doc + Torna 组成行业领先的文档生成和管理解决方案，使用 smart-doc 无侵入完成 Java 源代码分析和提取注释生成 API 文档，自动将文档推送到 Torna 企业级接口文档管理平台。
[smart-doc+Torna 文档自动化]( https://gitee.com/smart-doc-team/smart-doc/wikis/smart-doc 与 torna 对接?sort_id=3695028)
这是行业内目前唯一实现从注释提取生成文档到文档管理平台完全开源的自动化方案
这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.