Skip to content

docs: the fork-rebase runbook, and the release prerequisites named where callers read - #6

Merged
ddespinoza merged 1 commit into
mainfrom
feat/retro-35-runbook
Oct 24, 2026
Merged

ddespinoza merged 1 commit into
mainfrom
feat/retro-35-runbook

Conversation

@ddespinoza

Copy link
Copy Markdown
Contributor

Cierra #4, cierra #5 (retro of instalador #35).

What & why

  1. docs/fork-rebase.md (Retro #35: falta el runbook de rebase de fork — el próximo fork vuelve a derivar todo el procedimiento #4) — the IntraVox rebase procedure, improvised once and now written down: the pre-rewrite twin (rebase --skip for the duplicate), the per-path merge policy (bundles → theirs; ratchets and l10n manifests → regenerate at the end; everything else by hand with both-sides constructor merges), the reconciliation commit pattern, the regenerate-last order, the four-gate verification with the zero-deletions diff against the backup ref, and the force-push-main-then-PR flow. Two more fork rebases (eurooffice, desktop_workspace) are waiting in #27's P2.
  2. app-release.yml header (Retro #35: los prerrequisitos de publicación (entorno release, secretos, ruleset de tags) no están escritos en ningún lado #5) — one comment block naming what a calling repo needs before its first v* tag: the release environment with both secrets, the v* tag ruleset, and a default-branch pin (the local-only-SHA failure mode that cost the #35 session five API calls). Comment-only; existing SHA pins are untouched.

IntraVox's AGENTS.md already points at the runbook (APS-Conecta/IntraVox#19).

AI involvement

Written with AI assistance (Claude Code + pi).

…ere callers read

- docs/fork-rebase.md: the IntraVox rebase (instalador #35) written down as
  the road every fork app takes — the pre-rewrite twin, the per-path merge
  policy, the reconciliation commit, the regenerate-last order, the
  zero-deletions verification, and the force-push-then-PR flow. eurooffice
  and desktop_workspace are next.
- app-release.yml's header names what a calling repo needs before its first
  tag: the release environment with the two secrets, the v* tag ruleset, and
  a pin that points at a commit on the default branch.
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