java – 可以Spring restdocs生成像swagger这样的实时文档吗？

作为开发人员,我更喜欢spring restdocs.但作为文档的使用者,我发现swagger实时文档非常引人注目.这是无处不在的例子：http://petstore.swagger.io/

有没有办法用spring restdocs记录我的休息api,但生成像swagger petstore这样的实时文档？如果是这样,你怎么做？

解决方法:

不,它不可能开箱即用. REST Docs旨在可扩展,因此您可以自己添加功能,但这将是一项重大任务.

我是REST Docs项目的负责人,对实时文档的支持很有意义,但目前并不是特别重要的.根据我的经验,实时文档可以作为游乐场使用,但实际记录服务的工作很差.我目前的重点是制作准确且结构良好的文档.如果你正在寻找比Asciidoctor的空白画布更具指导性的东西,那么使用带有Slate的REST Docs可以为你提供一个大的快速启动.

标签：spring-restdocs,java,spring,rest
来源： https://codeday.me/bug/20190727/1555259.html