Doc: Describe detaching views

Fixes: QTCREATORBUG-29636
Change-Id: I980d7c523bd40cbc7ad56696987688839baf154d
Reviewed-by: David Schulz <david.schulz@qt.io>

doc/qtcreator/src/analyze/creator-valgrind.qdoc

@@ -324,6 +324,7 @@
 
     \endlist
 
+    \sa {Detach views}
 */
 
 /*!

doc/qtcreator/src/editors/creator-only/creator-coding-edit-mode.qdoc

@@ -338,4 +338,6 @@
     \QC underlines semantic errors in olive in the C++ code editor. To check the
     correct paths for includes that are not resolved or that are resolved to the
     wrong file, select \uicontrol {Project Parts} > \uicontrol {Header Paths}.
+
+    \sa {Detach views}
 */

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

@@ -124,6 +124,7 @@
 
     \list
         \li \l {Assign keyboard shortcuts}
+        \li \l {Detach views}
         \li \l {Find a particular preference}
         \li \l {Find keyboard shortcuts}
         \li \l {Find menu items on \macos}

doc/qtcreator/src/qtcreator-toc.qdoc

@@ -262,6 +262,7 @@
             \li Use the UI
                 \list
                     \li \l {Assign keyboard shortcuts}
+                    \li \l {Detach views}
                     \li \l {Find a particular preference}
                     \li \l {Find keyboard shortcuts}
                     \li \l {Find menu items on \macos}

doc/qtcreator/src/user-interface/creator-only/creator-how-to-detach-views.qdoc

@@ -0,0 +1,41 @@
+// Copyright (C) 2023 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+/*!
+    \page creator-how-to-detach-views.html
+    \previouspage creator-how-tos.html
+
+    \ingroup creator-how-to-ui
+
+    \title Detach views
+
+    You can detach \QC views that have the \inlineimage icons/detach-view.png
+    icon. You can then move them to other places on the screen or to other
+    screens.
+
+    To detach views:
+
+    \list
+        \li Double-click the title bar of the view.
+        \li Grab the title bar of the view with the mouse and start moving the
+            view to another position on the screen.
+        \li Select \inlineimage icons/detach-view.png
+            .
+    \endlist
+
+    To show the title bars of views, select \uicontrol View > \uicontrol Views,
+    and deselect the \uicontrol {Automatically Hide Title Bars} check box.
+
+    \section1 Attach views
+
+    To attach views, drag them to a highlighted dock area.
+
+    \image qtcreator-attach-views.webp {Attaching a view to a dock area}
+
+    \section1 Revert changes
+
+    To open closed views, select \uicontrol View > \uicontrol Views.
+
+    To revert the changes, select \uicontrol View > \uicontrol Views >
+    \uicontrol {Reset to Default Layout}.
+*/