写接口免不了写接口文档，但是当文档与代码分开独立演进的时候，会发生很多不同步的问题。 接口描述与代码同步的最简便的方式就是利用java doc，改代码或参数的时候，顺便把java doc也更新了。
阅读背景：
spring boot rest接口自动生成文档（包含swagger）
来源：互联网
写接口免不了写接口文档，但是当文档与代码分开独立演进的时候，会发生很多不同步的问题。 接口描述与代码同步的最简便的方式就是利用java doc，改代码或参数的时候，顺便把java doc也更新了。
分享到：
