发布流程
本文档解释了 Symfony 内容管理框架的发布流程。有关核心 Symfony 发布流程,请参阅核心文档 core Symfony release process。
Symfony CMF 通过基于时间的模型管理其发布;新的 Symfony CMF 版本每六个月发布一次。我们希望与核心 Symfony 发布日期同步,并在 Symfony 发布后约一个月发布一个版本。这应该导致在六月和十二月发布版本。
此发布周期适用于 symfony-cmf/symfony-cmf
仓库 和 symfony-cmf 标准版。如果需要,各个 CMF 扩展包和组件可能会更频繁地发布次要版本。symfony-cmf/symfony-cmf
将始终指向一个可用的组合,并且仅在计划 CMF 的次要版本发布时才集成较新的次要版本。
点版本(即 1.0.1
)用于快速提供重要的修复程序。新功能永远不会添加到点版本中,而只会添加到次要版本中。随着 1.0 版本的发布,我们将创建一个 1.0 分支来维护此类修复程序,并且 master 将成为 1.1.x-dev 的别名。
当包含的扩展包之一进行点版本发布时,CMF 标准版和 symfony-cmf 将获得点版本。
开发
六个月的周期分为两个阶段
- 开发:四个月用于添加新功能和增强现有功能;
- 稳定化:两个月用于修复错误并准备发布。
在开发阶段,如果任何新功能无法及时完成,或者不够稳定以包含在当前最终版本中,则可以撤消该功能。
维护
CMF 是一项社区努力,因此不能保证维护。如果您需要维护合同,请与首席开发人员联系。他们在互联网机构工作,将能够提供支持和维护合同。
向后兼容性
我们努力遵守 semver。如果可能,我们将提供向后兼容 (BC) 的次要版本。如果这样做过于麻烦,我们将升级到新的主要版本。主要版本不一定遵循 Symfony 框架的主要版本。
UPGRADE.md
文档将帮助你升级次要版本和主要版本。
弃用
当功能实现无法在不破坏向后兼容性的情况下被更好的实现替换时,仍然可以弃用旧的实现,并添加一个新的首选实现。阅读 conventions 文档,了解有关 Symfony 中如何处理弃用的更多信息。
理由
采用此发布流程是为了提供更多的可预测性和透明度。它在很大程度上受到了 核心 Symfony 发布流程 的启发。