Swagger.io 的演进

  2015年5月18日

许多 Swagger 用户(包括新手和高级用户)都希望有一个更好的 Swagger 网站,以便更容易地了解 Swagger、其规范和工具、最佳实践等。我们终于达到了一个令人满意的阶段,可以在我们新的平台(基于 Wordpress 和 GitHub)上推出改进后的 swagger.io,这将使我们能够在未来几周和几个月内构建更多内容。

本网站的大部分内容实际上是从 GitHub 上的相应页面提取的;您会在每个页面上看到一个“在 GitHub 上查看源代码”链接——它会将您带到 GitHub 上相应的 Markdown 页面,您可以像以前一样对其进行分支和提交更改——允许您根据需要添加或更正任何内容(有关此过程的更多信息,请参阅贡献到 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

© . All rights reserved.