Smart-Doc Project

Introduce

smart-doc is a tool that supports both JAVA REST API and Apache Dubbo RPC interface document generation. Smart-doc is based on interface source code analysis to generate interface documents, and zero annotation intrusion. You only need to write Javadoc comments when developing, smart-doc can help you generate Markdown or HTML5 document. smart-doc does not need to inject annotations into the code like Swagger.

quick start

Documentation

Features

Zero annotation, zero learning cost, only need to write standard JAVA document comments.
Automatic derivation based on source code interface definition, powerful return structure derivation support.
Support Spring MVC, Spring Boot, Spring Boot Web Flux (Not support endpoint), Feign ,JAX-RS.
Supports the derivation of asynchronous interface returns such as Callable, Future, CompletableFuture.
Support JSR-303 parameter verification specification.
Support for automatic generation of request examples based on request parameters.
Support for generating JSON return value examples.
Support for loading source code from outside the project to generate field comments (including the sources jar package).
Support for generating multiple formats of documents: Markdown,HTML5,Asciidoctor,Postman Collection 2.0+,OpenAPI 3.0.
Support for exporting error codes and data dictionary codes to API documentation.
The debug html5 page fully supports file upload and download testing.
Support Apache Dubbo RPC.

Best Practice

smart-doc + Torna form an industry-leading document generation and management solution, using smart-doc to complete Java source code analysis and extract annotations to generate API documents without intrusion, and automatically push the documents to the Torna enterprise-level interface document management platform.

Building

You could build with the following commands. (Java 1.8 is required to build the master branch)

mvn clean install -Dmaven.test.skip=true

TODO

GRPC
SOCKET
WORD

Who is using

These are only part of the companies using smart-doc, for reference only. If you are using smart-doc, please add your company here to tell us your scenario to make smart-doc better.