Swagger 使用者(包括新手和進階使用者)提出的許多要求之一,是希望有一個更好的 Swagger 網站,讓大家更容易了解 Swagger、規範和工具、最佳實務等。我們終於到了可以推出經過改進的 swagger.io 的地步,該網站是建立在我們的新平台(基於 Wordpress 和 GitHub)之上,這將使我們能夠在未來幾週和幾個月內建立此內容。
本網站上的大部分內容實際上是從 GitHub 上對應的頁面提取的;您會在每個頁面上看到「在 GitHub 上檢視原始碼」的連結,它會將您帶到 GitHub 上對應的 markdown 頁面,您可以像以前一樣 fork 並提交變更,讓您可以新增或更正任何您認為合適的內容(在貢獻 swagger.io中閱讀更多關於該過程的資訊)。
顯然,這裡仍然缺少很多東西,在我們待新增的內容清單中,我們有:
- 關於 Swagger 如何適應 API 生命週期的高層次資訊
- 在您的專案中使用規範和工具的最佳實務
- 來自會議和聚會的影片/錄音
- 關於即將發布的版本和相關路線圖的資訊
- 關於 Swagger 規範和核心工具的治理資訊
- 不同社群專案的重點
- 您要求的任何內容!
專屬開發團隊正在加速發展!
在建置這個新網站的同時,我們也正在深入研究為核心 swagger 工具建立一個專屬的開發團隊;目前有 5 個人正在加速解決 swagger-core、swagger-codegen、swagger-ui 和 swagger-js 中的問題,以便在 Tony、Ron 和我本人的共同努力下推出下一個主要版本。
聚會和 Swagger 擁護者
我們方面採取的另一項行動是透過支持越來越多的 Swagger 聚會,並組建一個由專屬的 Swagger 擁護者組成的團體,加速在整個 API 社群中推廣 Swagger - Lorinda 將會發布更新,因此請查看公告頁面以取得更多詳細資訊。
請隨時透過 Google 群組、Twitter 或直接透過電子郵件與我們聯繫 - 我們很樂意聽取您對 swagger.io 的下一步以及我們如何讓 API 定義的世界變得更美好的想法。
一如既往地感謝您 - 謙卑的您!
/Ole