我們已經很久沒有發布關於 Swagger 的最新消息了，但現在給您一些更新還不算太晚！在過去的幾個月裡，我們努力進行了一些變更，有些是技術性的，有些則更面向使用者。在這篇文章中，我們將嘗試涵蓋其中一些更新，不分重要性順序。
一般發佈
我們為各種專案發布了許多版本，並且可能沒有意義全部介紹。但是，如果您不知道，我們所有的發布版本都附帶發布說明，其中詳細說明了改進、錯誤修正以及（我們盡量避免的）重大變更。
GitHub 中的每個專案都有一個「發布」區段，例如：https://github.com/swagger-api/swagger-ui/releases。
您可以在那裡找到我們所有的說明和各種版本。追蹤新版本的另一個好方法是「關注」專案，並將其設定為「僅發布」。這樣，您只會在發布版本時收到通知，而不會收到提交的所有問題和 PR。
值得注意的發布版本
即使我們定期發布版本，我們最近也發布了一些提供新功能的版本。所有新專案現在也基於 OpenAPI 3.0！
我們正式發布了驗證器徽章的第 2 版。在我們變更專案的基礎架構時，API 保持不變，並增加了現在支援 Swagger/OpenAPI 2.0 之上的 OpenAPI 3.0 的額外好處。
為了反映此變更，專案的 master 分支代表目前版本，而 v1 分支則具有先前版本的副本。
託管版本更新：直到今天，託管版本都存在於 https://online.swagger.io/validator 下。目前，此 URL 仍然有效並公開驗證器的 v1。新版本的驗證器託管於 https://validator.swagger.io 下，而最新版本的 Swagger UI 使用該 URL。我們強烈建議使用舊 URL 的使用者切換到新 URL。在未來，我們將會將舊 URL 重新導向到新 URL，或者關閉它。
回報問題和提交貢獻：驗證器徽章專案是一個簡單的 Web 服務專案，封裝了 Swagger Parser。如果您對 Web 服務有任何問題（例如，API 未如預期般運作），請在 https://github.com/swagger-api/validator-badge 中提交問題。但是，如果您發現驗證本身有問題，請在 https://github.com/swagger-api/swagger-parser 中提交問題。如果您不確定，請不用擔心，在您想要的地方提交問題，我們會視需要轉移它。
轉換器是一個較新的專案。我們已經在幕後使用它一段時間了，現在終於以開源方式發布它。就像驗證器徽章一樣，Swagger 轉換器是一個包裝 Swagger Parser 的 Web 服務，提供將較舊的定義檔案轉換為 OpenAPI 3 的功能。託管版本在 https://converter.swagger.io 上線，您也可以自行建構並執行，或使用 Docker 映像檔。
回報問題和提交貢獻：如果您對 Web 服務有任何問題（例如，API 未如預期般運作），請在 https://github.com/swagger-api/swagger-converter 中提交問題。但是，如果您發現轉換本身有問題，請在 https://github.com/swagger-api/swagger-parser 中提交問題。同樣地，如果您不確定，只需在您想要的地方提交問題，我們會視需要轉移它。
等等，什麼？！經過漫長的等待，寵物商店的 OpenAPI 3 版本現在上線了！
目前，您可以在 https://petstore3.swagger.io 找到它。未來，我們將會以 v3 取代主要的 https://petstore.swagger.io，並將 v2 保留在單獨的 URL 中。
Pet Store v3 目前只是將 v2 簡單遷移到 OpenAPI 3。但是，現在我們並沒有充分利用 OAS3 的功能。我們確實想要改變這一點，而您也可以提供協助！
與先前使用代碼優先方法的寵物商店版本不同，在新版本的寵物商店中，我們使用了設計優先的方法。這表示即使您不熟悉程式碼本身，只要您知道 OpenAPI 3，您就可以提交 PR 並協助我們改進寵物商店本身。請記住，寵物商店不一定是要展示良好的 API 設計，而是更要涵蓋規格的不同功能。
另一個變更，是現在更容易找到寵物商店的原始碼。只需跳到 https://github.com/swagger-api/swagger-petstore。兩個託管版本都在那裡（v3 的 master 分支，v2 的 v2 分支）。
回報問題和提交貢獻：現在有了新的儲存庫，提交想法、修正和變更比以往更容易。只需前往 https://github.com/swagger-api/swagger-petstore 即可開始。如果您只想對公開的 API 提出建議，只需對 https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml 提交 PR，這就是設計優先方法的奇妙之處。
新的貢獻指南
開源專案的一大優勢是可以根據您自己的需求貢獻並改進它們。無論您是新手還是經驗豐富的使用者，您可能對最佳貢獻方式有一些疑問。
我們重視您的時間，並感謝您願意提供協助。以下是一些資訊，可協助您入門。請記住，開源貢獻有很多形式，而不僅僅是程式碼貢獻。
在我們的 貢獻指南中，我們描述了各種協助方式，從回答問題、測試到進行程式碼變更。
對於那些不知道的人，當您在 GitHub 中開啟新問題時，右側面板底部會有一個（或多個）連結，指向專案維護人員提供的常用資源。例如
您可以在這裡找到貢獻指南的來源：https://github.com/swagger-api/.github/blob/master/CONTRIBUTING.md。
如同以往，我們歡迎您的意見和貢獻，請記住，這是我們所有專案的通用指南。