From 93fcd753c82d71679c334f3d7b97ed8f3ae35cff Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Fri, 5 Jul 2024 16:36:27 +0200
Subject: [PATCH] Doc: Fix navigation

- Add "User Interface" and "Configuring Qt Creator" to the TOC
- Fix a \previouspage link to point to the How To topic
- Arrange Reference topic categories in alphabetic order

Change-Id: I674db28d089f5dd13a0bd16d34682fff8887b8ee
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
---
 doc/qtcreator/config/style/qt5-sidebar.html   |  2 ++
 doc/qtcreator/src/analyze/creator-heob.qdoc   |  2 +-
 .../creator-only/creator-reference.qdoc       | 28 +++++++++----------
 3 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/doc/qtcreator/config/style/qt5-sidebar.html b/doc/qtcreator/config/style/qt5-sidebar.html
index f048c0c6c35..340da73317c 100644
--- a/doc/qtcreator/config/style/qt5-sidebar.html
+++ b/doc/qtcreator/config/style/qt5-sidebar.html
@@ -15,6 +15,8 @@
     <div class="indexboxcont indexboxbar">
         <ul>
             <li><a href="creator-overview.html">Overview</a></li>
+            <li><a href="creator-quick-tour.html">User Interface</a></li>
+            <li><a href="creator-configuring.html">Configuring Qt Creator</a></li>
             <li><a href="creator-project-creating.html">Creating Projects</a></li>
             <li><a href="creator-configuring-projects.html">Configuring Projects</a></li>
             <li><a href="creator-debugging.html">Debugging</a></li>
diff --git a/doc/qtcreator/src/analyze/creator-heob.qdoc b/doc/qtcreator/src/analyze/creator-heob.qdoc
index 45f2b269ed6..33d9568c07b 100644
--- a/doc/qtcreator/src/analyze/creator-heob.qdoc
+++ b/doc/qtcreator/src/analyze/creator-heob.qdoc
@@ -9,7 +9,7 @@
 
 /*!
     \page creator-how-to-use-heob.html
-    \previouspage creator-clang-tools.html
+    \previouspage creator-how-tos.html
 
     \ingroup creator-how-to-analyze
 
diff --git a/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc
index 6f2ed53a14e..03e81452f75 100644
--- a/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc
+++ b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc
@@ -19,20 +19,6 @@
 
     \annotatedlist creator-reference-analyzer
 
-    \section1 Debuggers
-
-    Set up and use debuggers to debug executable binary files, as well as
-    QML, Java, and Python source code.
-
-    \annotatedlist creator-reference-debugger
-
-    \section2 Debugger Views
-
-    Inspect the state of your application while debugging in the
-    \uicontrol Debug mode.
-
-    \annotatedlist creator-reference-debugger-views
-
     \section1 Build Systems
 
     When you create projects, you can choose the build system to use for
@@ -50,6 +36,20 @@
 
     \annotatedlist creator-reference-build-configurations
 
+    \section1 Debuggers
+
+    Set up and use debuggers to debug executable binary files, as well as
+    QML, Java, and Python source code.
+
+    \annotatedlist creator-reference-debugger
+
+    \section2 Debugger Views
+
+    Inspect the state of your application while debugging in the
+    \uicontrol Debug mode.
+
+    \annotatedlist creator-reference-debugger-views
+
     \section1 Devices
 
     Connect devices to the computer to run, debug, and analyze applications