Co-locate all Release CLI docs

doc/user/project/releases/index.md

@@ -250,27 +250,6 @@ The `ADDITIONAL_CA_CERT_BUNDLE` value can also be configured as a
 either as a `file`, which requires the path to the certificate, or as a variable,
 which requires the text representation of the certificate.
 
-## GitLab Release CLI tool
-
-The [GitLab Release CLI (`release-cli`)](https://gitlab.com/gitlab-org/release-cli) tool
-is a command-line tool for managing releases from the command line or from a CI/CD pipeline.
-You can use the release CLI to create, update, modify, and delete releases.
-
-When you [use a CI/CD job to create a release](#creating-a-release-by-using-a-cicd-job),
-the `release` keyword entries are transformed into Bash commands and sent to the Docker
-container containing the `release-cli` tool. The tool then creates the release.
-
-You can also call the `release-cli` tool directly from a [`script`](../../../ci/yaml/index.md#script).
-For example:
-
-```shell
-release-cli create --name "Release $CI_COMMIT_SHA" --description \
-  "Created using the release-cli $EXTRA_DESCRIPTION" \
-  --tag-name "v${MAJOR}.${MINOR}.${REVISION}" --ref "$CI_COMMIT_SHA" \
-  --released-at "2020-07-15T08:00:00Z" --milestone "m1" --milestone "m2" --milestone "m3" \
-  --assets-link "{\"name\":\"asset1\",\"url\":\"https://example.com/assets/1\",\"link_type\":\"other\"}
-```
-
 ### Create multiple releases in a single pipeline
 
 A pipeline can have multiple `release` jobs, for example:

doc/user/project/releases/release_cli.md

@@ -4,16 +4,38 @@ group: Release
 info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
 ---
 
-# Install the `release-cli` for the Shell executor **(FREE)**
+
+# GitLab Release CLI tool
+
+The [GitLab Release CLI (`release-cli`)](https://gitlab.com/gitlab-org/release-cli) tool
+is a command-line tool for managing releases from the command line or from a CI/CD pipeline.
+You can use the release CLI to create, update, modify, and delete releases.
+
+When you [use a CI/CD job to create a release](index.md#creating-a-release-by-using-a-cicd-job),
+the `release` keyword entries are transformed into Bash commands and sent to the Docker
+container containing the `release-cli` tool. The tool then creates the release.
+
+You can also call the `release-cli` tool directly from a [`script`](../../../ci/yaml/index.md#script).
+For example:
+
+```shell
+release-cli create --name "Release $CI_COMMIT_SHA" --description \
+  "Created using the release-cli $EXTRA_DESCRIPTION" \
+  --tag-name "v${MAJOR}.${MINOR}.${REVISION}" --ref "$CI_COMMIT_SHA" \
+  --released-at "2020-07-15T08:00:00Z" --milestone "m1" --milestone "m2" --milestone "m3" \
+  --assets-link "{\"name\":\"asset1\",\"url\":\"https://example.com/assets/1\",\"link_type\":\"other\"}
+```
+
+## Install the `release-cli` for the Shell executor **(FREE)**
 
 > - [Introduced](https://gitlab.com/gitlab-org/release-cli/-/issues/21) in GitLab 13.8.
-> - [Changed](https://gitlab.com/gitlab-org/release-cli/-/merge_requests/108) in GitLab 14.2, the `release-cli` binaries are also [available in the Package Registry](https://gitlab.com/jaime/release-cli/-/packages).
+> - [Changed](https://gitlab.com/gitlab-org/release-cli/-/merge_requests/108) in GitLab 14.2, the `release-cli` binaries are also [available in the Package Registry](https://gitlab.com/gitlab-org/release-cli/-/packages).
 
 When you use a runner with the Shell executor, you can download and install
 the `release-cli` manually for your [supported OS and architecture](https://release-cli-downloads.s3.amazonaws.com/latest/index.html).
 Once installed, [the `release` keyword](../../../ci/yaml/index.md#release) is available to use in your CI/CD jobs.
 
-## Install on Unix/Linux
+### Install on Unix/Linux
 
 1. Download the binary for your system from S3, in the following example for amd64 systems:
 
@@ -41,7 +63,7 @@ Once installed, [the `release` keyword](../../../ci/yaml/index.md#release) is av
    release-cli version 0.6.0
    ```
 
-## Install on Windows PowerShell
+### Install on Windows PowerShell
 
 1. Create a folder somewhere in your system, for example `C:\GitLab\Release-CLI\bin`