我见过这个Spring REST Docs - video
我们正在进行Spring启动项目，并使用springfox库生成Swagger-ui和swagger文档，如here所述
我们喜欢Spring Rest文档可以用来生成REST API文档，以及我们不需要在我们的Controller代码中添加像@ApiResponse或@ApiOperation这样的swagger注释 . 此外，文档现在与代码一起存在 .
但是如果使用Spring Rest文档，我们将错过为我们的API自动生成的Swagger-UI（当我们使用swagger集成时） .
Spring REST文档是否可以生成像Swagger UI这样的测试UI .
1 回答
这直接违背了Spring REST Docs的设计理念和意图 . 其中一个主要目标是文档与单元测试相关联，因此即使您在REST Contract 中进行逻辑或签名更改，您也知道您的文档非常可靠 .
此外，您链接的视频提供了许多自动化文档生成如何产生大量不良预期输出的示例 .
因此，它可以选择做更多工作来获得更好的文档，或者选择完全自动化的选项以节省时间并使其变得可行，但质量较低的文档 . 这是你的首要任务 .