Update maintainers_guide.md

Author: TinaMor

build/scripts/release/MAINTAINERS_GUIDE.md

@@ -6,7 +6,7 @@
 
 ### Create a GitHub tag
 
-1. Get the new module version:
+1. **Get the new module version:**
 
     To choose the new version, you can use the [Semantic Versioning](https://semver.org/) scheme. The version number is in the format `X.Y.Z`, where:
     - `X` is the *major* version number. Indicates significant **changes that may break backward compatibility** with previous versions (e.g., 1.0.0 to 2.0.0).
@@ -30,30 +30,30 @@
     $RELEASE_TAG = "v${RELEASE_VERSION}"
     ```
 
-    > [!IMPORTANT]  
-    > Ensure that the new version number is not already used in the [PowerShell Gallery][ctk-psg].
-    > If the version already exists, you will need to increment the version number.
-    > The PowerShell Gallery does not support permanent deletion of packages.
-    > Use the `Find-Module` command to check if the version already exists.
-    >
-    > ```PowerShell
-    > Find-Module -Name containers-toolkit -AllowPrerelease -RequiredVersion "$RELEASE_VERSION" | Where-Object { $_.Version -eq $RELEASE_VERSION }
-    > ```
-    > Alternatively, you can use the [build/hacks/get-newversion.ps1](../../hacks/get-newversion.ps1) script to get the new version number.
-    >
-    > ```PowerShell
-    > $RELEASE_TAG = build/hacks/get-newversion.ps1 -Version $NEW_VERSION -Prerelease $PRERELEASE_TAG -ReleaseType "major"
-    > ```
-
-
-1. Create a new branch from the main branch.
+> [!IMPORTANT]  
+> Ensure that the new version number is not already used in the [PowerShell Gallery][ctk-psg].
+> If the version already exists, you will need to increment the version number.
+> The PowerShell Gallery does not support permanent deletion of packages.
+> Use the `Find-Module` command to check if the version already exists.
+>
+> ```PowerShell
+> Find-Module -Name containers-toolkit -AllowPrerelease -RequiredVersion "$RELEASE_VERSION" | Where-Object { $_.Version -eq $RELEASE_VERSION }
+> ```
+>
+> Alternatively, you can use the [build/hacks/get-newversion.ps1](../../hacks/get-newversion.ps1) script to get the new version number.
+>
+> ```PowerShell
+> $RELEASE_TAG = build/hacks/get-newversion.ps1 -Version $NEW_VERSION -Prerelease $PRERELEASE_TAG -ReleaseType "major"
+> ```
+
+2. **Create a new branch from the main branch.**
 
     ```bash
     $BRANCH_NAME = "release/$RELEASE_TAG"
     git checkout -b "$BRANCH_NAME"
     ```
 
-1. Cherry-pick the changes to a new branch from the main branch. The new branch name should be `release/X.Y.Z`, where `X.Y.Z` is the new version number.
+3. **Cherry-pick the changes to a new branch** from the main branch. The new branch name should be `release/X.Y.Z`, where `X.Y.Z` is the new version number.
 
     - Identify the commit hashes you want to include. You can find them using:
 
@@ -78,32 +78,20 @@
         git cherry-pick --continue
         ```
 
-1. Update the module version in the README.md file
-
-    *NOTE: Only update the version number in the README.md file for the latest release and not for pre-releases._*
-
-1. Create a tag and a release in GitHub.
+4. **Create a tag and a release in GitHub.**
 
     ```bash
     git tag --sign "$RELEASE_TAG" -m "Release $RELEASE_TAG"
     git push upstream "$BRANCH_NAME" --tags
     ```
 
-    > [!TIP]  
-    > To delete an existing tag, use the following command:
-    >
-    > ```bash
-    > git tag --delete "$RELEASE_TAG"
-    > git push upstream :refs/tags/"$RELEASE_TAG"
-    > ```
-
-<!-- > [!NOTE]
-> <https://github.com/orgs/community/discussions/48462>
-> As of February 2025, GitHub does not have the option to only create a tag without creating a release. We therefore delete the release after creating the tag.
-
-```bash
-gh release delete -y $RELEASE_TAG
-``` -->
+> [!TIP]  
+> To delete an existing tag, use the following command:
+>
+> ```bash
+> git tag --delete "$RELEASE_TAG"
+> git push upstream :refs/tags/"$RELEASE_TAG"
+> ```
 
 ### Create a release using the ADO release pipeline
 
@@ -128,24 +116,26 @@ Releases are created using the Containers-Toolkit ADO release pipeline. The rele
 
     This publishes the module to the [PowerShell Gallery][ctk-psg] and creates a new release in GitHub.
 
-    1. Verify the PowerShell Gallery release:
+### Verify the release
 
-        ```PowerShell
-        Find-Module -Name containers-toolkit -AllVersions -AllowPrerelease
-        ```
+1. Verify the PowerShell Gallery release:
+
+    ```PowerShell
+    Find-Module -Name containers-toolkit -AllVersions -AllowPrerelease
+    ```
 
-        > [!IMPORTANT]
-        > If the module has any issues, unlist the version in the [PowerShell Gallery][ctk-psg].
-
-    1. Go to the created release in GitHub and do the following:
-        1. update the release notes.
-        2. Verify that all files have been uploaded correctly and the scripts are signed. There should be three files:
-            - *containers-toolkit-<RELEASE_TAG>.tar.gz*
-            - *containers-toolkit-<RELEASE_TAG>.zip*
-            - *containers-toolkit-<RELEASE_TAG>.SHA256*
-        3. By default, the release is marked as a draft. To publish the release:
-            - Click on the **Edit** button.
-            - If it is a pre-release, check the **Set as a pre-releasee** checkbox.
-            - Finally, click on the **Publish release** button.
+> [!IMPORTANT]
+> If the module has any issues, unlist the version in the [PowerShell Gallery][ctk-psg].
+
+2. Go to the created release in GitHub and do the following:
+    1. Update the release notes.
+    2. Verify that all files have been uploaded correctly and the scripts are signed. There should be three files:
+        - *containers-toolkit-<RELEASE_TAG>.tar.gz*
+        - *containers-toolkit-<RELEASE_TAG>.zip*
+        - *containers-toolkit-<RELEASE_TAG>.SHA256*
+    3. Publish the release. By default, the release is marked as a draft. To publish the release:
+        - Click on the **Edit** button.
+        - If it is a pre-release, check the **Set as a pre-releasee** checkbox.
+        - Finally, click on the **Publish release** button.
 
 [ctk-psg]: https://www.powershellgallery.com/packages/containers-toolkit