發布流程與規則¶

v2.6.2 版本新增。

從 v2.6.2 之後發布的版本開始，以下規則將規範並描述 Requests 核心團隊如何產生新的發布版本。

主要版本發布¶

主要版本發布將包含破壞性變更。當進行版本控制時，其版本號將會是 vX.0.0。例如，如果先前的版本發布是 v10.2.7，則下一個版本將會是 v11.0.0。

破壞性變更是指會破壞與先前版本回溯相容性的變更。如果專案要將 Response 物件上的 text 屬性變更為方法，則只會在主要版本發布中發生。

主要版本發布也可能包含其他錯誤修正。Requests 的核心開發人員致力於提供良好的使用者體驗。這表示我們也致力於盡可能地保持回溯相容性。主要版本發布將會不頻繁，並且在考慮之前需要有強而有力的理由。

次要版本發布將不會包含破壞性變更，但可能包含其他錯誤修正。如果先前發布的 Requests 版本是 v10.2.7，則次要版本發布的版本號將會是 v10.3.0。

次要版本發布將會與具有相同主要版本號的版本發布回溯相容。換句話說，所有以 v10. 開頭的版本都應該彼此相容。

Hotfix 版本發布將只包含在專案發布先前版本時遺漏的錯誤修正。如果先前發布的 Requests 版本是 v10.2.7，則 Hotfix 版本發布的版本號將會是 v10.2.8。

Hotfix 版本發布將不會包含在 v2.6.2 之後升級供應商提供的相依性。

在 2.5 和 2.6 版本發布系列中，Requests 核心團隊升級了供應商提供的相依性，並為使用者和核心團隊帶來了大量的麻煩。為了減少這種痛苦，我們正在制定一套具體的程序，以便適當地設定期望。