Commit 7424ed08 authored by Russell Dickenson's avatar Russell Dickenson

Merge branch 'docs-releases-notes' into 'master'

Remove note formatting from releases doc

See merge request gitlab-org/gitlab!44790
parents b3051866 ffa41a0f
...@@ -47,22 +47,20 @@ To view a list of releases: ...@@ -47,22 +47,20 @@ To view a list of releases:
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/32812) in GitLab 12.9. Releases can be created directly in the GitLab UI. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/32812) in GitLab 12.9. Releases can be created directly in the GitLab UI.
NOTE: **Note:**
Only users with Developer permissions or higher can create releases.
Read more about [Release permissions](../../../user/permissions.md#project-members-permissions).
You can create a release in the user interface, or by using the You can create a release in the user interface, or by using the
[Releases API](../../../api/releases/index.md#create-a-release). [Releases API](../../../api/releases/index.md#create-a-release).
We recommend using the API to create releases as one of the last steps in your We recommend using the API to create releases as one of the last steps in your
CI/CD pipeline. CI/CD pipeline.
Only users with Developer permissions or higher can create releases.
Read more about [Release permissions](../../../user/permissions.md#project-members-permissions).
To create a new release through the GitLab UI: To create a new release through the GitLab UI:
1. Navigate to **Project overview > Releases** and click the **New release** 1. Navigate to **Project overview > Releases** and click the **New release**
button. button.
1. In the [**Tag name**](#tag-name) box, enter a name. 1. In the [**Tag name**](#tag-name) box, enter a name.
NOTE: **Note:**
Creating a release based on an existing tag using the user Creating a release based on an existing tag using the user
interface is not yet supported. However, this is possible using the interface is not yet supported. However, this is possible using the
[Releases API](../../../api/releases/index.md#create-a-release). [Releases API](../../../api/releases/index.md#create-a-release).
...@@ -88,7 +86,6 @@ release tag. When the `released_at` date and time has passed, the badge is autom ...@@ -88,7 +86,6 @@ release tag. When the `released_at` date and time has passed, the badge is autom
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/26016) in GitLab 12.6. Asset link editing was [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9427) in GitLab 12.10. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/26016) in GitLab 12.6. Asset link editing was [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9427) in GitLab 12.10.
NOTE: **Note:**
Only users with Developer permissions or higher can edit releases. Only users with Developer permissions or higher can edit releases.
Read more about [Release permissions](../../../user/permissions.md#project-members-permissions). Read more about [Release permissions](../../../user/permissions.md#project-members-permissions).
...@@ -225,7 +222,6 @@ The release title can be customized using the **Release title** field when ...@@ -225,7 +222,6 @@ The release title can be customized using the **Release title** field when
creating or editing a release. If no title is provided, the release's tag name creating or editing a release. If no title is provided, the release's tag name
is used instead. is used instead.
NOTE: **Note:**
Guest users of private projects are allowed to view the **Releases** page Guest users of private projects are allowed to view the **Releases** page
but are _not_ allowed to view details about the Git repository (in particular, but are _not_ allowed to view details about the Git repository (in particular,
tag names). Because of this, release titles are replaced with a generic tag names). Because of this, release titles are replaced with a generic
...@@ -254,7 +250,6 @@ Every release has a description. You can add any text you like, but we recommend ...@@ -254,7 +250,6 @@ Every release has a description. You can add any text you like, but we recommend
including a changelog to describe the content of your release. This helps users including a changelog to describe the content of your release. This helps users
quickly scan the differences between each release you publish. quickly scan the differences between each release you publish.
NOTE: **Note:**
[Git's tagging messages](https://git-scm.com/book/en/v2/Git-Basics-Tagging) and [Git's tagging messages](https://git-scm.com/book/en/v2/Git-Basics-Tagging) and
Release note descriptions are unrelated. Description supports [Markdown](../../markdown.md). Release note descriptions are unrelated. Description supports [Markdown](../../markdown.md).
...@@ -334,8 +329,7 @@ generate release evidence for an existing release. Because of this, each release ...@@ -334,8 +329,7 @@ generate release evidence for an existing release. Because of this, each release
can have multiple release evidence snapshots. You can view the release evidence and can have multiple release evidence snapshots. You can view the release evidence and
its details on the Releases page. its details on the Releases page.
NOTE: **Note:** When the issue tracker is disabled, release evidence [can't be downloaded](https://gitlab.com/gitlab-org/gitlab/-/issues/208397).
When the issue tracker is disabled, release evidence [cannot be downloaded](https://gitlab.com/gitlab-org/gitlab/-/issues/208397).
Here is an example of a release evidence object: Here is an example of a release evidence object:
...@@ -431,10 +425,13 @@ ruby: ...@@ -431,10 +425,13 @@ ruby:
junit: rspec.xml junit: rspec.xml
``` ```
If the pipeline ran successfully, when you create your release, the `rspec.xml` file is saved as release evidence. If the pipeline ran successfully, when you create your release, the `rspec.xml` file is saved as
release evidence.
NOTE: **Note:** If you [schedule release evidence collection](#schedule-release-evidence-collection),
If you [schedule release evidence collection](#schedule-release-evidence-collection), some artifacts may already be expired by the time of evidence collection. To avoid this you can use the [`artifacts:expire_in`](../../../ci/yaml/README.md#artifactsexpire_in) keyword. Learn more in [this issue](https://gitlab.com/gitlab-org/gitlab/-/issues/222351). some artifacts may already be expired by the time of evidence collection. To avoid this you can use
the [`artifacts:expire_in`](../../../ci/yaml/README.md#artifactsexpire_in)
keyword. Learn more in [this issue](https://gitlab.com/gitlab-org/gitlab/-/issues/222351).
### Schedule release evidence collection ### Schedule release evidence collection
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment