发布版本#

我们的目标#

我们的发布策略描述了我们如何决定何时发布主题的新公开版本，以便其他项目可以使用新功能和改进。它试图平衡这些目标

  • 相对频繁地发布，以便我们为使用该主题的项目提供持续的改进，并最大程度地减少升级所需的工作量。

  • 不要让人意外（尤其是负面意外），并为项目提供时间来提供有关即将推出的功能的反馈。

  • 最大程度地减少与发布相关的繁琐工作和复杂性，并减少与它们相关的信息孤岛和瓶颈。

何时发布版本#

任何人都可以尝试发布新版本，如果

  • 距离上次发布已超过一个月。

  • 或者对我们的代码进行了重大更改，需要发布。

  • 并且没有带有 impact: block-release 标签的未解决问题。

发布候选版本#

如果发布包括复杂或大量更改（尤其是在 JavaScript 中），请创建一个 release candidate 并征求用户的反馈。这很重要，因为我们没有在测试基础设施中测试大部分 CSS 和基于 JavaScript 的功能。大约一周后，如果自发布候选版本以来没有出现阻塞问题，我们可以进行完整的发布。

发布版本的流程#

此主题使用 GitHub 标签和发布自动将新版本推送到 PyPI。按照以下步骤发布版本

  • (可选) 创建 GitHub 里程碑 以组织应在发布新版本时解决的问题。

  • 确定是否该发布版本，请阅读 何时发布版本 并确定是否该发布版本。

  • 将 发布清单 复制到新问题中.

  • 完成清单。就这样！

选择版本递增#

我们使用 语义化版本控制 来决定是主要版本、次要版本还是补丁版本。在我们发布 1.0 之前，将次要版本视为重大发布，将补丁版本视为功能/补丁发布。如果这是发布候选版本，请将其标记为 0.1rc1。