Skip to content

Commit 9099d47

Browse files
koistyaclaude
andcommitted
docs: correct what is editable on an immutable release
"Managing releases in a repository" claimed that only the title and release notes can be edited after an immutable release is published. Measured against a repository with immutable releases enabled, a published release also accepts changes to its pre-release and latest flags and stays immutable; what is rejected is uploading or deleting assets and moving the tag. The allowlist also contradicted the concepts page, which lists exactly those two protections. Replace it with a denylist, and document on the concepts page that a release can be published as a pre-release, verified over the public download path a draft does not offer, and then promoted. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Bgb78NQ4wnUob76NZETBAZ
1 parent c14044c commit 9099d47

2 files changed

Lines changed: 7 additions & 1 deletion

File tree

content/code-security/concepts/supply-chain-security/immutable-releases.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,10 @@ Additionally, creating an immutable release automatically generates a **release
2929
3030
If a release is immutable, you will see {% octicon "lock" aria-hidden="true" %} **Immutable**" below the title on the release page.
3131

32+
## What you can still change
33+
34+
Immutability protects the assets and Git tag of a release. After an immutable release is published, you can still edit its title and release notes, and change whether it is marked as a pre-release or as the latest release.
35+
3236
## Best practices for publishing immutable releases
3337

3438
We recommend you use the following workflow for publishing an immutable release.
@@ -39,6 +43,8 @@ We recommend you use the following workflow for publishing an immutable release.
3943

4044
This ensures that all assets are in place before the release becomes immutable, preventing the need to work around immutability restrictions.
4145

46+
Draft releases are not public, so their assets cannot be downloaded the way consumers download them. To check that path before you promote a release, publish it as a pre-release, verify the published assets, then edit the release to clear **This is a pre-release** and select **Set as latest release**.
47+
4248
## Next steps
4349

4450
To learn how to enable immutable releases for your repository or organization, see [AUTOTITLE](/code-security/how-tos/secure-your-supply-chain/establish-provenance-and-integrity/prevent-release-changes).

content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ If you @mention any {% data variables.product.github %} users in the notes, the
8181
{% ifversion immutable-releases %}
8282

8383
> [!NOTE]
84-
> If you have enabled immutable releases for your repository, you can only edit the title and release notes after a release is published. See [AUTOTITLE](/code-security/concepts/supply-chain-security/immutable-releases).
84+
> If you have enabled immutable releases for your repository, you cannot add, replace, or delete assets, or move the tag, after a release is published. You can still edit the title and release notes, and change whether the release is a pre-release or the latest release. See [AUTOTITLE](/code-security/concepts/supply-chain-security/immutable-releases).
8585
8686
{% endif %}
8787

0 commit comments

Comments
 (0)