You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+20-2Lines changed: 20 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -545,6 +545,8 @@ This project follows the GitHub Community Guidelines. Please be respectful and i
545
545
546
546
Releases are triggered manually by a core team member using the GitHub Actions release workflow.
547
547
548
+
> **Note:** The release workflow publishes the new version as a **prerelease** on GitHub. Once the release is verified, a maintainer must **manually promote it to a full release and move the `latest` tag** so that users installing with `version: latest` receive the new version.
549
+
548
550
### Steps
549
551
550
552
1.**Launch the release action**
@@ -563,7 +565,17 @@ Releases are triggered manually by a core team member using the GitHub Actions r
563
565
564
566
3.**Approve the environment gate**
565
567
566
-
Return to the paused release run in [`github/gh-aw`](https://github.com/github/gh-aw/actions). Approve the **`gh-aw-actions-release`** environment gate. The workflow will verify that the new tag exists in `github/gh-aw-actions` and then publish the GitHub release.
568
+
Return to the paused release run in [`github/gh-aw`](https://github.com/github/gh-aw/actions). Approve the **`gh-aw-actions-release`** environment gate. The workflow will verify that the new tag exists in `github/gh-aw-actions` and then publish the GitHub release as a **prerelease**.
569
+
570
+
4.**Promote to latest**_(manual step)_
571
+
572
+
After verifying the prerelease is working correctly:
573
+
574
+
a. **Edit the GitHub release** — go to the [Releases page](https://github.com/github/gh-aw/releases), open the new prerelease, uncheck **This is a pre-release**, and save. This promotes the release to a stable full release.
575
+
576
+
b. **Move the `latest` tag** — GitHub's release API resolves `latest` to the most recent non-prerelease release. Promoting the release in step (a) is sufficient for the `latest` resolution to update automatically.
577
+
578
+
Users who install with `version: latest` (the default) will now receive the new release.
567
579
568
580
### Summary
569
581
@@ -583,7 +595,13 @@ Merge the sync-actions PR
583
595
Approve the gh-aw-actions-release environment gate
584
596
│
585
597
▼
586
-
Release published 🎉
598
+
Release published as prerelease 🎉
599
+
│
600
+
▼ (manual)
601
+
Promote prerelease → full release on GitHub Releases page
0 commit comments