背景
迄今为止,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 治理模型。一个用于讨论 Swagger 治理的独立 Google 群组已在 https://groups.google.com/forum/#!forum/swagger-governance 可用,我们强烈建议您在那里发表评论,让我们了解您在这方面的需求和担忧。此外,请在 Twitter 上关注 swagger-api ,以确保您能收到此项工作进展的最新公告。
如果 Swagger 的治理对您来说是一个重要问题,请参与这些讨论并表达您的意见。我们真诚地希望找到一个能让社区对 Swagger 的未来保持活力和热情的治理模型。
Swagger 团队 @
SmartBear Software