通过这篇博文，我们开启了为期两周的 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 的副本放在键盘旁边，这都是您影响规范草案的最佳机会，因为它将在发布前进行。
以下是一些提供反馈的方法
- 拉取请求 – 如果您有一个相对简单的更改，请在 GitHub 上提交拉取请求 (PR)：https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.md
- 问题：如果您有更一般的反馈，您可以提交一个问题：https://github.com/OAI/OpenAPI-Specification/issues
该OpenAPI 规范 v3处于“候选版本”阶段。在一些领域，评论会特别有用，例如示例的清晰度和功能的描述。欢迎您提出新功能或对现有功能进行重大更改的建议，但在大多数情况下，这些建议只会在下一次发布中予以考虑。
注意：TDC 成员表示他们更喜欢拉取请求，因为这样可以使意图更清晰，并且所有更改最终都必须通过此阶段。如果您无法提交 PR，则提交问题是次佳选择。
如果您想全面了解 OpenAPI 规范 v3，请查看
- OpenAPI 规范 v3 系列简介：https://www.openapis.org.cn/specification/v3insights
正在播放： Semisonic 的《Closing Time》