swagger.io 的演变

  2015 年 5 月 18 日

Swagger 用户(包括新手和高级用户)提出的许多要求之一是围绕 Swagger 构建一个更好的网站,使其更容易了解 Swagger、规范和工具、最佳实践等。我们终于达到了一个满意的程度,可以在我们新的平台(基于 Wordpress 和 GitHub)之上推出改进后的 swagger.io,这将使我们能够在未来几周和几个月内构建此内容。

本网站上的大部分内容实际上是从 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