Swagger 治理的後續步驟

  2015 年 5 月 26 日

背景

到目前為止,Swagger 規格和工具的治理一直非常非正式。Tony Tam(Swagger 專案的創始人)歷來扮演著仁慈的獨裁者的角色,加上他對 Swagger 的明確願景以及它應該和不應該解決的問題,效果一直很好。許多人根據他的想法貢獻了程式碼(並繼續這樣做),而 Tony 非常樂於接受任何使 Swagger 更吸引使用者的貢獻。

去年發布的 Swagger 規格 2.0 版,在一個有 400 多名參與者的工作小組中進行了討論,其中許多人積極參與了討論,最終的決定由 Tony 在小組的指導下做出。

我們現在在哪裡?

在過去一年中,Swagger 取得了巨大的增長,並且專案管理權在 2015 年 3 月中旬從 Reverb 轉移到 SmartBear Software。隨著這種增長和轉變,對 Swagger 更新的治理模型的需求已變得顯而易見,旨在處理專案規模的擴大,並回答關於所有權、開放性、授權、協作、願景等問題。

在過去幾週中,我們與 Swagger 社群的成員進行了初步討論,以收集他們在規格、核心工具以及更高層級的專案治理方面的需求和疑慮。在這些會議中討論的問題是推動此進展的核心。例如

  • 我們應該繼續採用仁慈的獨裁制,還是開放採用更任人唯賢的方法
  • 關於規格的治理結構和流程是否應該與支援工具的治理結構和流程不同?
  • 參與治理和流程是否應該完全基於程式碼貢獻,還是也應該基於其他方面?
  • 我們如何找到一種模型,使供應商和個別社群貢獻者都能夠影響 Swagger 的未來?
  • 我們如何找到一種模型,以協作方式繼續支持工具和規格的快速演進?
  • 等等...

這些討論的會議記錄已由Marsh Gardiner收集,可在http://bit.ly/swaggergov取得。

下一步是什麼?

接下來,我們希望在未來 4-6 週內,根據 Swagger 社群的持續回饋,提出 Swagger 的治理模型。一個單獨的 Google 群組,用於討論 Swagger 的治理,網址為https://groups.google.com/forum/#!forum/swagger-governance,我們強烈建議您在那裡發表評論,讓我們了解您在這方面的需求和疑慮。此外,請在 Twitter 上追蹤swagger-api,以確保您收到此進展的最新公告。

如果 Swagger 的治理對您來說是一個重要的問題,請參與這些討論,並表達您的意見。我們真的希望找到一種治理模型,使社群對 Swagger 的未來保持權力和熱情。

/Swagger 團隊 @

SmartBear Software