我很高興地宣布 Spring REST Docs 1.0.0.RELEASE 已經發布。 它可以從 Maven Central 和我們的 發布儲存庫 取得。

什麼是 Spring REST Docs？

Spring REST Docs 協助您為 RESTful 服務建立文件。 它結合了使用 Asciidoctor 編寫的手寫文件和使用 Spring MVC Test 自動產生的程式碼片段。 這種方法使您擺脫了像 Swagger 這樣的工具所帶來的限制。 它可以幫助您產生準確、簡潔且結構良好的文件。 然後，此文件可讓您的使用者以最少的麻煩獲得他們需要的資訊。

如果您想查看使用 Spring REST Docs 產生的文件，請查看簡單 RESTful 筆記服務的範例 API 指南 和 入門指南。

入門

若要開始使用 Spring REST Docs，請參考 入門章節 參考文件。

謝謝

衷心感謝 Spring 社群的成員，他們幫助塑造了 Spring REST Docs 1.0。 如果沒有您的功能建議、Pull Request 和錯誤報告，它就不會是現在的樣子。 謝謝您。