docs(governance): add backport policy (Backport Policy for release branches) - #1743
Merged
RUKAYAT-CODER merged 1 commit intoSep 30, 2026
Conversation
Adds Governance/policies/BACKPORT.md defining which branches receive backports (main, release/x.y, published release lines), the eligibility criteria a fix must meet before it is backported, and the approval process (tracking issue, maintainer triage, two maintainer approvals with review independence, required CI, changelog entry, and mandatory forward-port). Links it from the Policies index in Governance/README.md and cross-references HOTFIX, APPROVAL_REQUIREMENTS, VERSIONING, CHANGELOG_POLICY, and SECURITY_POLICY. Closes rinafcode#1624 🤖 Generated with Codebuff Co-Authored-By: Codebuff <noreply@codebuff.com>
|
@iyanumajekodunmi756 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits. You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀 |
Contributor
|
Thank you for contributing to the project. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a versioned backport policy for TeachLink Backend, closing the governance gap identified in #1624. The
Governance/policies/folder had no reference for how fixes move from the current development line to older release branches; this document makes backporting predictable instead of an ad-hoc negotiation during an incident.Per the issue's implementation plan, the policy documents:
main(hotfixes and forward-ports),release/x.ystabilisation branches, and publishedrelease/x.y.zmaintenance lines, with rules that only supported lines are eligible, backports branch from the fork point, no forward drift is allowed, and cherry-picks are made with-xto record the source commit.VERSIONING.md), carry regression tests with green suites on the target line, and have a tracked issue or advisory.backport/x.y/issue-<N>-<slug>) → PR against the release branch with two maintainer approvals including a code owner for hotfix paths and author/approver independence → required CI (lint, format, typecheck, build, migrations, tests) with no skipped checks → merge, changelog entry, and mandatory forward-port so lines never silently diverge.Changes
Governance/policies/BACKPORT.mdGovernance/README.mdScope: exactly two files, both under
Governance/. No changes anywhere else in the repository, satisfying the issue's acceptance criteria.Consistency with existing governance
DEPRECATION.md,CREDITS.md): Status/Version/Owner/Last reviewed header, numbered sections, and a version-table change log (v1.0.0).CONTRIBUTING.md§3/§11 (main,develop,hotfix/*, back-merge rule), the hotfix gates inGovernance/processes/HOTFIX.md, approval counts inpolicies/APPROVAL_REQUIREMENTS.md, PATCH semantics inpolicies/VERSIONING.md§7, changelog requirements inpolicies/CHANGELOG_POLICY.md, and supported-line rules inSECURITY_POLICY.md.Regression tests
Not applicable — documentation-only change. It adds two Markdown files and modifies no TypeScript, configuration, schema, or dependency.
Governance/is outside the Jest root (rootDir: 'src'), outside the TypeScript build (tsconfig.build.jsoncompilessrc/), and no existing test, build step, or runtime path is affected.Local CI verification
All CI-equivalent checks from
.github/workflows/ci.ymlrun locally on this branch:pnpm run lint:cipnpm run typecheckpnpm run buildpnpm run migrations:checkgit ls-files 'dist/' '*.tsbuildinfo'The remaining CI jobs (
migration:run, drift check, revert, test suites, security scan) require a provisioned PostgreSQL service and exercise application code; none are affected by a Markdown-only change underGovernance/.Acceptance criteria
BACKPORT.mdwith backport branches, eligibility criteria, and approval process)Governance/folderGovernance/README.md)Closes #1624