Skip to content

Commit 95daee9

Browse files
OgeonX-AiAitomates
andauthored
docs(release): define Pages publication ordering (#16)
Co-authored-by: Kim Harjamäki <kim.harjamaki@prosimo.fi>
1 parent 0b35b98 commit 95daee9

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/DISTRIBUTION.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,16 @@ a schema tag can no longer clobber each other on the single Pages origin.
5555

5656
Repository administrators must configure GitHub Pages to use **GitHub Actions** as its source. Publication uses GitHub's OIDC token and does not require stored deployment credentials.
5757

58+
### Release ordering
59+
60+
GitHub Pages identifies deployments by commit SHA. A release tag created on the
61+
same commit as a just-finished default-branch deployment can therefore produce a
62+
different artifact that Pages treats as the same deployment. After creating a
63+
schema release tag, merge a post-release metadata commit (for example, advancing
64+
the changelog) on the default branch. That deployment runs from a new SHA, sees
65+
the new tag, and publishes the complete immutable release set. Verify both the
66+
immutable manifest and the stable-line index before declaring the release done.
67+
5868
## Custom domain (optional future work)
5969

6070
When `schemas.coding-autopilot.dev` is activated, it must serve the same

0 commit comments

Comments
 (0)