lock-release-docs

name	lock-release-docs
description	Lock docs and scripts on a release branch to a specific patch version
argument-hint	<release-branch> <version>
disable-model-invocation	true

Lock all documentation and scripts on a release branch so they reference a specific version instead of floating references like main or latest.

Arguments: $0 = release branch (e.g. release-1.9), $1 = version to lock to (e.g. 1.9.3)./

Before starting

1. Fetch from the upstream remote.
2. Check out $0 and make sure it is up to date with upstream/$0.
3. Create a working branch (e.g. lock-$0-docs) off of $0.

What to search for

Search docs/ and hack/ thoroughly for the patterns below. Do not assume a fixed set of files -- new docs or scripts may introduce new instances over time.

Floating GitHub URLs pointing at main

Any raw.githubusercontent.com/akuity/kargo/main/... or github.com/akuity/kargo/tree/main/... URL should be updated to reference the release branch instead (e.g. for raw content URLs, for tree links).