Fix #59: Clarify steps when creating a release (#60)

Author: tomschr

changelog.d/59.doc.rst

@@ -0,0 +1 @@
+Clarify some steps when creating a release.

docs/source/developer/create-release.rst

@@ -3,14 +3,22 @@
 Creating a New Release
 ======================
 
-To create a new release, follow these steps:
+When you are ready to release a new version of the project, start with creating a new release branch. There you bump the version, build the changelog, and adjust minor things like the documentation. Avoid commiting changes that introduces new features or add breaking changes.
+
+Follow these steps:
 
 #. Ensure that you have the latest changes from the main branch of the repository.
 #. Create a new branch named ``release/<VERSION>``, where ``<VERSION>`` is the version number you are releasing (e.g., ``release/1.0.0``).
 #. :ref:`Bump the version <bump-version>`.
 #. :ref:`Update the project <update-project>`.
 #. :ref:`Build the changelog <build-changelog>`.
+#. In your current branch, push the branch to the remote repository:
+
+   .. code-block:: console
+
+      git push origin HEAD
+
 #. Wait for the CI to pass. If it fails, fix the issues and commit again.
 #. If the CI passes, (squash-)merge your release branch into the main branch.
    The GitHub Action workflow will automatically create a new release based on the name of the release branch.
-#. Find the release in the GitHub repository under the |gh_release| section.
+#. Find the release in the GitHub repository under the |gh_release| section.

docs/source/reference/_autoapi/docbuild/cli/index.rst

@@ -9,8 +9,10 @@ docbuild.cli
 
    * :class:`~docbuild.cli.cmd_build`: Build the documentation.
    * :class:`~docbuild.cli.cmd_c14n`: Canonicalize the documentation.
+   * :class:`~docbuild.cli.cmd_config`: Configuration management for docbuild CLI commands.
    * :class:`~docbuild.cli.cmd_cli`: Main CLI entry point for docbuild.
-   * :class:`~docbuild.cli.config`: Configuration management for docbuild CLI commands.
+   * :class:`~docbuild.cli.cmd_metadata`: Metadata management for docbuild.
+   * :class:`~docbuild.cli.cmd_validate`: Validate the documentation.
 
    Additional modules:
    * :class:`~docbuild.cli.context`: Context for the docbuild CLI commands.
@@ -27,10 +29,10 @@ Submodules
    /reference/_autoapi/docbuild/cli/cmd_build/index
    /reference/_autoapi/docbuild/cli/cmd_c14n/index
    /reference/_autoapi/docbuild/cli/cmd_cli/index
+   /reference/_autoapi/docbuild/cli/cmd_config/index
    /reference/_autoapi/docbuild/cli/cmd_metadata/index
    /reference/_autoapi/docbuild/cli/cmd_repo/index
    /reference/_autoapi/docbuild/cli/cmd_validate/index
-   /reference/_autoapi/docbuild/cli/config/index
    /reference/_autoapi/docbuild/cli/context/index
    /reference/_autoapi/docbuild/cli/defaults/index