Doc: Turn Managing Sessions into a how-to topic

Task-number: QTCREATORBUG-29361
Change-Id: If15556fdcb5d365b65f1f56a77ab9c21739d0854
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>

doc/qtcreator/src/editors/creator-locator.qdoc

@@ -170,7 +170,7 @@
     \section2 Opening Sessions from Locator
 
     You can use the filter that triggers menu commands to open
-    \l{Managing Sessions}{sessions}. Enter
+    \l{Manage sessions}{sessions}. Enter
     \c {t yoursess} or \c {t sess yoursess} to trigger \uicontrol File >
     \uicontrol Sessions > \e <session_name>.
 

doc/qtcreator/src/editors/creator-only/creator-clang-codemodel.qdoc

@@ -149,7 +149,7 @@
     \image qtcreator-toggle-progress-bar.webp {Toggle Progress Details button}
 
     By default, \QC runs one clangd process per project. If you have created
-    \l{Managing Sessions}{sessions} that have related projects, you can
+    \l{Manage sessions}{sessions} that have related projects, you can
     specify that the projects in the session should be managed by a single
     clangd process.
 

doc/qtcreator/src/howto/creator-only/creator-cli.qdoc

@@ -197,15 +197,13 @@
             \li -lastsession
             \li ProjectExplorer plugin: load the last session when \QC starts.
                 Open the projects and files that were open when you last exited
-                \QC. For more information about managing sessions, see
+                \QC.
-                \l{Managing Sessions}.
 
         \row
             \li <session>
             \li ProjectExplorer plugin: load the given session when \QC starts.
                 Open the projects and files that were open when you last exited
-                \QC. For more information about managing sessions, see
+                \QC.
-                \l{Managing Sessions}.
 
     \endtable
 
@@ -225,5 +223,5 @@
     You can also switch to a dark theme to customize the appearance of widgets,
     colors, and icons without using stylesheets.
 
-    \sa {Run Qt Creator from the command line}
+    \sa {Run Qt Creator from the command line}, {Manage sessions}
 */

doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc

@@ -173,7 +173,7 @@
 
     To open a project that is located in a particular directory, you can
     pass on the directory name as a command-line argument. \QC looks for
-    a \l{Managing Sessions}{session} that matches the directory name and
+    a \l{Manage sessions}{session} that matches the directory name and
     loads it. Or it looks for a project file in the directory and opens it.
 
     For example, on Windows:

doc/qtcreator/src/howto/creator-sessions.qdoc

@@ -13,11 +13,13 @@
     \previouspage creator-project-managing-workspaces.html
     \nextpage creator-keyboard-shortcuts.html
     \else
-    \previouspage creator-sharing-project-settings.html
+    \previouspage creator-how-tos.html
-    \nextpage creator-design-mode.html
     \endif
 
-    \title Managing Sessions
+    \ingroup creator-how-to-use
+    \ingroup studio-how-to
+
+    \title Manage sessions
 
     When you exit \QC, it stores a snapshot of your current workspace as a
     \e session. To restore the session automatically when you start \QC,
@@ -61,6 +63,8 @@
 
     To save a session under a new name, select \uicontrol Clone.
 
+    \section1 Create new sessions
+
     To create a new session:
 
     \list 1
@@ -76,9 +80,12 @@
 
     \endlist
 
+    \section1 Open sessions
+
     To switch between sessions, select \uicontrol {Open}.
 
     \if defined(qtcreator)
+
     The \uicontrol Projects tab in the \uicontrol Welcome mode lists existing
     sessions. To open a session, select it or press
     \key Ctrl+Alt+<number>, where \e <number> is the number of the session to
@@ -96,7 +103,7 @@
     When you start \QC from the command line, you can give the name of
     a session as an argument and \QC will start with this session.
 
-    For more information, see \l{Command-Line Options}.
+    \sa {Command-Line Options}, {Searching with the Locator}
     \endif
 
 */

doc/qtcreator/src/projects/creator-only/creator-projects-overview.qdoc

@@ -16,10 +16,6 @@
 
     \image front-projects.png
 
-    You can share projects with other designers and developers across different
-    development platforms with a common tool for design, development, and
-    debugging.
-
     \list
 
         \li \l{Creating Projects}
@@ -42,14 +38,8 @@
             configurations for \QC and your projects. You can modify
             the settings in the \uicontrol Projects mode.
 
-        \li \l{Managing Sessions}
-
-            Sessions store items such as open files, breakpoints, and evaluated
-            expressions, which you do not typically want to share across
-            platforms.
-
     \endlist
 
-    \sa {Build Systems}
+    \sa {Manage Projects}{How To: Manage Projects}, {Manage sessions},
-
+    {Build Systems}
 */

doc/qtcreator/src/projects/creator-only/creator-projects-settings-dependencies.qdoc

@@ -46,6 +46,6 @@
 
     \note You cannot use this view to specify subprojects for projects.
 
-    \sa {Add subprojects to projects}, {Managing Sessions}
+    \sa {Add subprojects to projects}, {Manage sessions}
 
 */

doc/qtcreator/src/qtcreator-toc.qdoc

@@ -42,7 +42,6 @@
                 \li \l{Using Custom Output Parsers}
                 \li \l{Sharing Project Settings}
             \endlist
-            \li \l{Managing Sessions}
         \endlist
         \li \l{Designing User Interfaces}
         \list

doc/qtcreator/src/qtcreator.qdoc

@@ -53,7 +53,6 @@
                     \li \l{Creating Projects}
                     \li \l{Version Control Systems}
                     \li \l{Configuring Projects}
-                    \li \l{Managing Sessions}
                 \endlist
             \li \b {\l{Designing User Interfaces}}
                 \list

doc/qtcreator/src/user-interface/creator-projects-view.qdoc

@@ -19,7 +19,7 @@
 
     \if defined(qtcreator)
     The project tree has a list of all projects open in the current
-    \l{Managing Sessions}{session}. For each project, the tree visualizes
+    \l{Manage sessions}{session}. For each project, the tree visualizes
     the build system structure of the project and lists all files that
     are part of the project.
 

doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc

@@ -36,7 +36,7 @@
                                 \li \l{Qt Insight}
                            \endlist
                         \li \l{Managing Workspaces}
-                        \li \l{Managing Sessions}
+                        \li \l{Manage sessions}
                         \li \l{Keyboard Shortcuts}
                     \endlist
                 \li \l{Creating Projects}