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: content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md
+37-18Lines changed: 37 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ shortTitle: Manage releases
22
22
---
23
23
## About release management
24
24
25
-
You can create new releases with release notes, @mentions of contributors, and links to binary files, as well as edit or delete existing releases.
25
+
You can create new releases with release notes, @mentions of contributors, and links to binary files, as well as edit or delete existing releases. You can also create, modify, and delete releases by using the Releases API. For more information, see "[Releases](/rest/releases/releases)" in the REST API documentation.
26
26
27
27
{% ifversion fpt or ghec %}
28
28
You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. For more information, see "[Publishing an action in the {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace)."
@@ -36,43 +36,62 @@ You can choose whether {% data variables.large_files.product_name_long %} ({% da
36
36
37
37
{% data reusables.repositories.navigate-to-repo %}
38
38
{% data reusables.repositories.releases %}
39
-
3. Click **Draft a new release**.
39
+
1. Click **Draft a new release**.
40
40
41
41
{% ifversion fpt or ghec or ghes > 3.4 or ghae > 3.4 %}{% else %}{% endif %}
42
-
4. {% ifversion fpt or ghec or ghes > 3.2 or ghae %}Click **Choose a tag**, type{% else %}Type{% endif %} a version number for your release{% ifversion fpt or ghec or ghes > 3.2 or ghae %}, and press **Enter**{% endif %}. Alternatively, select an existing tag.
42
+
1. {% ifversion fpt or ghec or ghes > 3.2 or ghae %}Click **Choose a tag**, type{% else %}Type{% endif %} a version number for your release{% ifversion fpt or ghec or ghes > 3.2 or ghae %}, and press **Enter**{% endif %}. Alternatively, select an existing tag.
43
43
44
44
{% ifversion fpt or ghec or ghes > 3.2 or ghae %}
45
-
5. If you are creating a new tag, click **Create new tag**.
45
+
1. If you are creating a new tag, click **Create new tag**.
46
46
47
-
47
+
{%- data reusables.releases.previous-release-tag %}
56
-
6. Type a title and description for your release.
60
+
1. Type a title and description for your release.
57
61
{%- ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %}
58
62
If you @mention anyone in the description, the published release will include a **Contributors** section with an avatar list of all the mentioned users.
59
63
{%- endif %}
60
64
{% ifversion fpt or ghec or ghes > 3.3 %} Alternatively, you can automatically generate your release notes by clicking {% ifversion previous-release-tag %}**Generate release notes**{% else %}**Auto-generate release notes**{% endif %}.{% endif %}{% ifversion previous-release-tag %}
{% else %}
67
+
68
+
{% endif %}
69
+
63
70
1. Optionally, to include binary files such as compiled programs in your release, drag and drop or manually select files in the binaries box.
64
-
65
-
2. To notify users that the release is not ready for production and may be unstable, select **This is a pre-release**.
66
-
71
+
72
+
73
+
74
+
1. To notify users that the release is not ready for production and may be unstable, select **This is a pre-release**.
75
+
76
+
77
+
78
+
{%- ifversion releases-set-latest-release %}
79
+
1. Optionally, you can select **Set as latest release**. If you do not select this option, the latest release label will automatically be assigned based on semantic versioning.
80
+
81
+
82
+
83
+
{%- endif %}
67
84
{%- ifversion discussions %}
68
85
1. Optionally, if {% data variables.product.prodname_discussions %} are enabled in the repository, select **Create a discussion for this release**, then select the **Category** drop-down menu and click a category for the release discussion.
69
-
86
+
87
+
88
+
70
89
{%- endif %}
71
-
9. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**.
90
+
1. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**.
72
91
73
92
74
93
{%- ifversion fpt or ghec or ghes > 3.2 or ghae > 3.3 %}
75
-
You can then view your published or draft releases in the releases feed for your repository. For more information, see "[Viewing your repository's releases and tags](/github/administering-a-repository/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags)."
94
+
You can then view your published or draft releases in the releases feed for your repository. For more information, see "[Screenshot of your repository's releases and tags](/github/administering-a-repository/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags)."
76
95
77
96
{% ifversion fpt or ghec or ghes > 3.4 or ghae > 3.3 %}
78
97
0 commit comments