Spring springdocs可以生成像swagger這樣的實時文檔嗎？

Question

作為開發人員，我更喜歡spring restdocs。 但作為文檔的使用者，我發現swagger實時文檔非常引人注目。 這是無處不在的例子： http ： //petstore.swagger.io/

有沒有辦法用spring restdocs記錄我的休息api，但生成像swagger petstore這樣的實時文檔？ 如果是這樣，你怎么做？

Answer 1

不，它不可能開箱即用。 REST Docs旨在可擴展，因此您可以自己添加功能，但這將是一項重大任務。

我是REST Docs項目的負責人，對實時文檔的支持很有意義，但目前並不是特別重要的。 根據我的經驗，實時文檔可以作為游樂場使用，但實際記錄服務的工作很差。 我目前的重點是制作准確且結構良好的文檔。 如果你正在尋找比Asciidoctor的空白畫布更具指導性的東西，那么使用帶有Slate的REST Docs可以為你提供一個大的快速啟動。