跳至主要内容
所有帖子作者

Rob Dolin

最后一次征求意见,请完成您的问题或 PR

作者 博客

通过这篇博文,我们开启了 OpenAPI 规范 v3 的为期两周的最后征求意见期。OpenAPI 规范 v3

如上月所述上个月,OpenAPI 规范 v3 现已进入最后征求意见期。您可以在以下地址找到 OpenAPI 规范 v3 的最新发布候选版本:https://github.com/OAI/OpenAPI-Specification/releases

在 6 月 16 日星期五的会议上,技术开发者社区 (TDC) 确认了以下日期

  • 从 5 月 22 日到 6 月 16 日的 4 周:解决剩余的拉取请求
  • 从 6 月 19 日到 6 月 30 日的 2 周:意见征集期 ← 您现在所处的位置
  • 从 7 月 3 日到 7 月 14 日的 2 周:解决剩余的意见和问题
  • 从 7 月 17 日到 7 月 21 日的 1 周:发布窗口(暂定)

无论您自 v2.0 以来是否没有查看过规范,或者是否将 v3.0.0-rc1 的磨损副本放在键盘旁边,这都是您影响规范草案在发布之前的最佳机会。

以下是一些您可以提供反馈的方式

OpenAPI 规范 v3处于“发布候选”阶段。意见特别有帮助的几个方面是示例的清晰度和功能的描述。欢迎提出新功能或对现有功能进行重大更改的建议,但很可能仅在将来的版本中予以考虑。

注意:TDC 成员表示更喜欢拉取请求,因为它使意图更清晰,并且因为所有更改最终都必须通过该阶段。如果您无法提交 PR,则问题是次佳选择。

如果您想全面了解 OpenAPI 规范 v3,请查看

正在播放: Semisonic 的《Closing Time》

 

OpenAPI Initiative 正在向您发送一张“请柬”

作者 博客

我们即将发布 OpenAPI 规范 v3.0.0 正式版。如果您一直在等待开始试用 OpenAPI 规范 (OAS) v3.0.0(前身为 Swagger),现在正是原型设计或编码的最佳时机。请将您的日历标记为 6 月 19 日星期一至 6 月 30 日星期五的为期两周的最后意见征集期,并留意 7 月份的最终版本。

3 月 1 日,OpenAPI Initiative (OAI) 宣布发布了第一个 OpenAPI 规范 v3.0.0 实现者草案。此版本被标记为 3.0.0-rc0,我们在 4 月底发布了后续版本,标记为 3.0.0-rc1

在 5 月 19 日星期五的会议上,技术开发者社区 (TDC) 同意将发布目标定为以下时间表

  • 从 5 月 22 日到 6 月 16 日的 4 周:解决剩余的拉取请求
  • 从 6 月 19 日到 6 月 30 日的 2 周:意见征集期
  • 从 7 月 3 日到 7 月 14 日的 2 周:解决剩余的意见和问题
  • 从 7 月 17 日到 7 月 21 日的 1 周:暂定发布窗口

如果您没有收到 OpenAPI 规范存储库中每次更改的移动设备推送通知,以下是一些有用的链接

如上所述,如果您还没有这样做,现在是审查最新的 OpenAPI 规范 v3.0.0 的好时机,考虑您的系统和工具如何利用 新功能,并在 v3.0.0 正式版发布之前考虑是否有任何可以改进的地方。

最后,如果您正在编写任何以任何方式使用 3.0 草案规范的工具,请通过完成此 非常简短的调查告知我们,因为只有通过针对草案规范实现代码,我们才能对其准备情况充满信心!

Tony Tam
SmartBear Software 的 Swagger 产品副总裁
Jeremy Whitlock
Google 软件工程师
Ron Ratovsky
SmartBear Software 的 Swagger 开发者布道师
Darrel Miller
Microsoft 软件开发人员
Marsh Gardiner
Google 产品经理
Jason Harmon
Typeform 的 API 主管