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