From ec7ae0a6b2bd2200eb76bb3cd62a7b4db909388b Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Tue, 20 May 2025 13:35:15 +0200
Subject: [PATCH] Doc: Describe adding annotated tags to Git branches
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task-number: QTCREATORBUG-32575
Change-Id: Id290445cabecb66568ee0fad72ca956ef3910d82

Reviewed-by: André Hartmann <aha_1980@gmx.de>
---
 dist/changelog/changes-17.0.0.md           | 3 ++-
 doc/qtcreator/src/vcs/creator-vcs-git.qdoc | 6 ++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/dist/changelog/changes-17.0.0.md b/dist/changelog/changes-17.0.0.md
index 879d71d307d..f6d59b95d3c 100644
--- a/dist/changelog/changes-17.0.0.md
+++ b/dist/changelog/changes-17.0.0.md
@@ -191,7 +191,8 @@ Version Control Systems
   ([Documentation](https://doc-snapshots.qt.io/qtcreator-17.0/creator-how-to-git-diff.html))
 * Added `Revert` to the actions in the `Instant Blame` tooltip
   ([Documentation](https://doc-snapshots.qt.io/qtcreator-17.0/creator-how-to-git-reset.html))
-* Added the option to create annotated tags to the `Create Branch` dialog
+* Added the option to create annotated tags to the `Add Tag` dialog
+  ([Documentation](https://doc-snapshots.qt.io/qtcreator-17.0/creator-how-to-git-log.html))
 * Added a `Diff & Cancel` option to the `Uncommitted Changes Found` dialog
   ([QTCREATORBUG-25795](https://bugreports.qt.io/browse/QTCREATORBUG-25795))
 * Added a `.gitignore` file when creating a repository in an existing directory
diff --git a/doc/qtcreator/src/vcs/creator-vcs-git.qdoc b/doc/qtcreator/src/vcs/creator-vcs-git.qdoc
index 00f561461b1..950ac1bef1f 100644
--- a/doc/qtcreator/src/vcs/creator-vcs-git.qdoc
+++ b/doc/qtcreator/src/vcs/creator-vcs-git.qdoc
@@ -368,7 +368,8 @@
             \li Learn More
         \row
             \li \uicontrol {Add Tag for <hash>}
-            \li Add a tag reference to the change.
+            \li Add a tag reference to the change. You can add an annotation to
+                the tag.
             \li
         \row
             \li \uicontrol {Checkout <hash>}
@@ -1170,7 +1171,8 @@
             \li Cherry-pick the selected change to the local repository.
         \row
             \li \uicontrol Revert
-            \li Revert back to the state of the last commit.
+            \li Revert the changes introduced by the commit. All other commits
+                remain unchanged.
         \row
             \li \uicontrol Show
             \li Show the commit in the diff editor.