Skip to content

docs(v2): unify branch naming and cross-repo version isolation - #22

Merged
servicememeai merged 5 commits into
devfrom
docs/v2/branch-governance-20261020
Oct 20, 2026
Merged

servicememeai merged 5 commits into
devfrom
docs/v2/branch-governance-20261020

Conversation

@servicememeai

Copy link
Copy Markdown

目标

统一 CloudFile Server / Hub / Docker 的分支语义,避免旧 V0.9、V2 DEV、Seafile CE14 源码基线及构建快照误用或互相合并。

本 PR(只改文档)

  • 将 dev 明确为唯一 V2 集成主线,新任务采用 feature/v2/<work>-<topic>、fix/v2/<work>-<topic>。
  • 规定 maintenance/v0.9/* 仅从旧版归档派生,不能整枝合入 V2;规范 sync/ce14/*、Docker-only release/v2.x.y、hotfix/*。
  • 明确三仓分支同名不等于兼容:CI/发布需保存 Server、Hub、Docker 的精确 SHA 组合,发行还需镜像 Digest。
  • 记录 2026-10-20 的历史分支清理评估:dev2-clean 与 dev14 为 dev 祖先,dev2 已分叉且有归档副本;旧 PR 不能直接按名称合并。
  • 记录现存 release.yaml 的浮动 dev / 空发布 SHA,以及 v2-clean.yml 锁定旧 source-set.json,这些属于待实现的 CI/发布门禁;纠正“CE14 无正式 Tag”和“从不存在的 prod 分支发布”等旧说明。

不在本 PR

  • 不删除、改名、重置任何现有分支;正在开发的三仓 feature/local-object-staging-20261020 原样保留。
  • 不修改构建、部署、环境配置或数据库。
  • 不把旧的 v2-clean 固定基线测试冒充当前 dev 组合测试。

后续执行顺序

  1. 按本规范调整多仓集成 CI:运行时解析 Server/Hub/Docker 的 SHA 快照,生成可检索验证收据。
  2. 收敛发布门禁:正式构建检查 release.yaml 的不可变三仓提交与镜像 Digest;v2-clean 历史基线结果与最新 dev 结果分别命名。
  3. 逐项核对引用、PR 和未移植提交后,再清理旧 dev2* / dev14 / V0.9 分支。
  4. 仓库管理员配置 dev 分支保护(至少禁止 force-push,并让跨仓门禁成为受控合并检查)。

参考:BRANCHING.md 和 docs/BRANCHES.md。

@servicememeai
servicememeai merged commit 926f6ca into dev Oct 20, 2026
3 checks passed
@opendev9
opendev9 deleted the docs/v2/branch-governance-20261020 branch October 21, 2026 00:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant