Improve documentation and console output when cutting docs releases

2 files changed, 4 insertions, 10 deletions

diff --git a/Rakefile b/Rakefile
index bc662c63..9b84c6ac 100644
--- a/Rakefile
+++ b/Rakefile
@@ -129,8 +129,8 @@ namespace :release do
     `git add .gitlab-ci.yml #{version}.Dockerfile`
     `git commit -m 'Release cut #{version}'`
 
-    puts "\n#{COLOR_CODE_GREEN}INFO: Created new Dockerfile: #{dockerfile}.#{COLOR_CODE_RESET}"
-    puts "#{COLOR_CODE_GREEN}INFO: You can now add, commit and push the new branch: git push origin #{version}.#{COLOR_CODE_RESET}"
+    puts "\n#{COLOR_CODE_GREEN}INFO: Created new Dockerfile:#{COLOR_CODE_RESET} #{dockerfile}."
+    puts "#{COLOR_CODE_GREEN}INFO: To push the new branch, run:#{COLOR_CODE_RESET} git push origin #{version}."
   end
 
   desc 'Creates merge requests to update the dropdowns in all online versions'
diff --git a/doc/releases.md b/doc/releases.md
index b353d83b..d2ad4066 100644
--- a/doc/releases.md
+++ b/doc/releases.md
@@ -68,8 +68,7 @@ To create a stable branch of the `gitlab-docs` project and a Docker image for th
 1. Update your local clone:
 
    ```shell
-   git stash -u
-   git fetch origin && git rebase origin/main
+   make update
    ```
 
 1. Run the Rake task to create the single version. For example, to create the 15.0 release branch
@@ -130,20 +129,15 @@ To create the release merge request for the release:
 1. Update your local clone:
 
    ```shell
-   git stash -u
-   git fetch origin && git rebase origin/main
+   make update
    ```
 
 1. Create a branch `release-X-Y`. For example:
 
    ```shell
-   git checkout main
    git checkout -b release-15-0
    ```
 
-   Confirm the branch has been created. Go to <https://gitlab.com/gitlab-org/gitlab-docs/-/branches/active>
-   and verify the branch is listed.
-
 1. Edit `content/_data/versions.yaml` and update the lists of versions to reflect the new release:
 
    - Add the latest version to the `online:` section.