這個案例的核心責任是記錄 Stripe 版本策略的現行切片、跟 2017 blog 構成演進對照。

觀察

現行 Stripe docs 描述的方案已從純日期版演進:major release 具名(如 Acacia)、含 backward-incompatible 變更;月度 release 只含相容變更、沿用上一個 major 名。docs 明列「什麼算 backwards-compatible」:新增資源、新增 optional 參數、新增 response property、property 順序改變、opaque string(object ID、可到 255 字元)長度格式改變、新增 event type。

判讀

同一家公司的版本策略會隨規模演進 — 2017 blog(C10)與現行 docs 是兩個時間切片、引用時要標時點。「相容變更清單」是變更紀律章的直接教材:把 client 不可依賴的介面性質(ID 長度、欄位順序)明文化、等於劃出契約邊界。

對應大綱

11.6 向後相容的變更紀律(清單主展開)、11.5 版本策略、11.1 契約劃界段交叉。與 C10 同 cluster。

下一步路由

模組十一案例庫

引用源