Doc: Rearrange tools page

Change-Id: I5f8212fe20ea2ec099769005b4a4920d70d86425
Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io>

2 files changed, 175 insertions, 177 deletions

diff --git a/sources/pyside6/doc/gettingstarted/package_details.rst b/sources/pyside6/doc/gettingstarted/package_details.rst
index f4a8c7d03..113edb686 100644
--- a/sources/pyside6/doc/gettingstarted/package_details.rst
+++ b/sources/pyside6/doc/gettingstarted/package_details.rst
@@ -68,180 +68,8 @@ which is the original QtCore library.
   Adding the full URL because it's a different sphinx project.
 .. _`Shiboken Documentation`: https://doc.qt.io/qtforpython/shiboken6/gettingstarted.html
 
-.. _package_tools:
-
 Tools Included
 --------------
 
-Following the same idea from the modules, we also include in the packages
-(wheels) Qt tools that are important for any Qt application development
-workflow, like ``uic``, ``rcc``, etc.
-
-All the tools **must** be used from the PySide wrappers, and not directly.
-For example, if exploring the ``site-packages/`` directory on your installation
-you find ``uic.exe`` (on Windows), you should not click on that, and use
-``pyside6-uic.exe`` instead.
-The reason for this is the proper setup of PATHs, plugins, and more,
-to properly work with the installed Python package.
-
-Here you can find all the tools we include in |project| starting
-from 6.3.0, grouped by different topics:
-
-Project development
-~~~~~~~~~~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-project``
-        :link: pyside6-project
-        :link-type: ref
-
-        to build Qt Designer forms (``.ui`` files), resource files (``.qrc``)
-        and QML type files (``.qmltype``) from a ``.pyproject`` file.
-
-Widget Development
-~~~~~~~~~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-designer``
-        :link: pyside6-designer
-        :link-type: ref
-
-        drag-and-drop tool for designing Widget UIs (generates ``.ui`` files,
-        see :ref:`using_ui_files`).
-
-    .. grid-item-card:: ``pyside6-uic``
-        :link: pyside6-uic
-        :link-type: ref
-
-        to generate Python code from ``.ui`` form files.
-
-    .. grid-item-card:: ``pyside6-rcc``
-        :link: pyside6-rcc
-        :link-type: ref
-
-        to generate serialized data from ``.qrc`` resources files.
-        Keep in mind these files can be used in other non-widget projects.
-
-
-QML Development
-~~~~~~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-qmllint``
-        :link: pyside6-qmllint
-        :link-type: ref
-
-        that verifies the syntactic validity of QML files.
-
-    .. grid-item-card:: ``pyside6-qmltyperegistrar``
-        :link: pyside6-qmltyperegistrar
-        :link-type: ref
-
-        to read metatypes files and generate files that contain the necessary
-        code to register all the types marked with relevant macros.
-
-    .. grid-item-card:: ``pyside6-qmlimportscanner``
-        :link: pyside6-qmlimportscanner
-        :link-type: ref
-
-        to identify the QML modules imported from a
-        project/QML files and dump the result as a JSON array.
-
-    .. grid-item-card:: ``pyside6-qmlcachegen``
-        :link: pyside6-qmlcachegen
-        :link-type: ref
-
-        to compile QML to bytecode at compile time for bundling inside the
-        binary.
-
-    .. grid-item-card:: ``pyside6-qml``
-        :link: pyside6-qml
-        :link-type: ref
-
-        to enable quick prototyping with QML files. This tool mimics some of
-        the capabilities of Qt's ``QML`` runtime utility by
-        directly invoking QQmlEngine/QQuickView.
-
-Translations
-~~~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-linguist``
-        :link: pyside6-linguist
-        :link-type: ref
-
-        for translating text in applications.
-
-    .. grid-item-card:: ``pyside6-lrelease``
-        :link: pyside6-lrelease
-        :link-type: ref
-
-        to create run-time translation files for the application.
-
-    .. grid-item-card:: ``pyside6-lupdate``
-        :link: pyside6-lupdate
-        :link-type: ref
-
-        to synchronize source code and translations.
-
-Qt Help
-~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-assistant``
-        :link: pyside6-assistant
-        :link-type: ref
-
-        for viewing online documentation in Qt Help file format.
-        Read more about the formats on the `QtHelp Framework`_ page.
-
-.. _`QtHelp Framework`: https://doc.qt.io/qt-6/qthelp-framework.html
-
-PySide Utilities
-~~~~~~~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-genpyi``
-        :link: pyside6-genpyi
-        :link-type: ref
-
-        to generate Python stubs (``.pyi`` files) for Qt modules.
-
-    .. grid-item-card:: ``pyside6-metaobjectdump``
-        :link: pyside6-metaobjectdump
-        :link-type: ref
-
-        a tool to print out the metatype information in JSON to be used as
-        input for ``qmltyperegistrar``.
-
-Deployment
-~~~~~~~~~~
-
-.. grid:: 2
-    :gutter: 3 3 4 5
-
-    .. grid-item-card:: ``pyside6-deploy``
-        :link: pyside6-deploy
-        :link-type: ref
-
-        to deploy PySide6 applications to desktop platforms - Linux, Windows
-        and macOS.
-
-    .. grid-item-card:: ``pyside6-android-deploy``
-        :link: pyside6-android-deploy
-        :link-type: ref
-
-        to deploy PySide6 application as an Android app targeting different
-        Android platforms - aarch64, armv7a, i686, x86_64.
+PySide6 comes bundled with a set of tools that assist in making the development experience with
+PySide6 more efficient. The list of tools can be found :ref:`here <package_tools>`.
diff --git a/sources/pyside6/doc/tools/index.rst b/sources/pyside6/doc/tools/index.rst
index 68a5d4fc5..a8b97a75f 100644
--- a/sources/pyside6/doc/tools/index.rst
+++ b/sources/pyside6/doc/tools/index.rst
@@ -1,7 +1,177 @@
+.. _package_tools:
+
 Tools
 =====
 
-.. toctree::
-   :glob:
+Following the same idea from the modules, we also include in the packages
+(wheels) Qt tools that are important for any Qt application development
+workflow, like ``uic``, ``rcc``, etc.
+
+All the tools **must** be used from the PySide wrappers, and not directly.
+For example, if exploring the ``site-packages/`` directory on your installation
+you find ``uic.exe`` (on Windows), you should not click on that, and use
+``pyside6-uic.exe`` instead.
+The reason for this is the proper setup of PATHs, plugins, and more,
+to properly work with the installed Python package.
+
+Here you can find all the tools we include in |project| starting
+from 6.3.0, grouped by different topics:
+
+Project development
+~~~~~~~~~~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-project``
+        :link: pyside6-project
+        :link-type: ref
+
+        to build Qt Designer forms (``.ui`` files), resource files (``.qrc``)
+        and QML type files (``.qmltype``) from a ``.pyproject`` file.
+
+Widget Development
+~~~~~~~~~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-designer``
+        :link: pyside6-designer
+        :link-type: ref
+
+        drag-and-drop tool for designing Widget UIs (generates ``.ui`` files,
+        see :ref:`using_ui_files`).
+
+    .. grid-item-card:: ``pyside6-uic``
+        :link: pyside6-uic
+        :link-type: ref
+
+        to generate Python code from ``.ui`` form files.
+
+    .. grid-item-card:: ``pyside6-rcc``
+        :link: pyside6-rcc
+        :link-type: ref
+
+        to generate serialized data from ``.qrc`` resources files.
+        Keep in mind these files can be used in other non-widget projects.
+
+
+QML Development
+~~~~~~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-qmllint``
+        :link: pyside6-qmllint
+        :link-type: ref
+
+        that verifies the syntactic validity of QML files.
+
+    .. grid-item-card:: ``pyside6-qmltyperegistrar``
+        :link: pyside6-qmltyperegistrar
+        :link-type: ref
+
+        to read metatypes files and generate files that contain the necessary
+        code to register all the types marked with relevant macros.
+
+    .. grid-item-card:: ``pyside6-qmlimportscanner``
+        :link: pyside6-qmlimportscanner
+        :link-type: ref
+
+        to identify the QML modules imported from a
+        project/QML files and dump the result as a JSON array.
+
+    .. grid-item-card:: ``pyside6-qmlcachegen``
+        :link: pyside6-qmlcachegen
+        :link-type: ref
+
+        to compile QML to bytecode at compile time for bundling inside the
+        binary.
+
+    .. grid-item-card:: ``pyside6-qml``
+        :link: pyside6-qml
+        :link-type: ref
+
+        to enable quick prototyping with QML files. This tool mimics some of
+        the capabilities of Qt's ``QML`` runtime utility by
+        directly invoking QQmlEngine/QQuickView.
+
+Translations
+~~~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-linguist``
+        :link: pyside6-linguist
+        :link-type: ref
+
+        for translating text in applications.
+
+    .. grid-item-card:: ``pyside6-lrelease``
+        :link: pyside6-linguist
+        :link-type: ref
+
+        to create run-time translation files for the application.
+
+    .. grid-item-card:: ``pyside6-lupdate``
+        :link: pyside6-linguist
+        :link-type: ref
+
+        to synchronize source code and translations.
+
+Qt Help
+~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-assistant``
+        :link: pyside6-assistant
+        :link-type: ref
+
+        for viewing online documentation in Qt Help file format.
+        Read more about the formats on the `QtHelp Framework`_ page.
+
+.. _`QtHelp Framework`: https://doc.qt.io/qt-6/qthelp-framework.html
+
+PySide Utilities
+~~~~~~~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-genpyi``
+        :link: pyside6-genpyi
+        :link-type: ref
+
+        to generate Python stubs (``.pyi`` files) for Qt modules.
+
+    .. grid-item-card:: ``pyside6-metaobjectdump``
+        :link: pyside6-metaobjectdump
+        :link-type: ref
+
+        a tool to print out the metatype information in JSON to be used as
+        input for ``qmltyperegistrar``.
+
+Deployment
+~~~~~~~~~~
+
+.. grid:: 2
+    :gutter: 3 3 4 5
+
+    .. grid-item-card:: ``pyside6-deploy``
+        :link: pyside6-deploy
+        :link-type: ref
+
+        to deploy PySide6 applications to desktop platforms - Linux, Windows
+        and macOS.
+
+    .. grid-item-card:: ``pyside6-android-deploy``
+        :link: pyside6-android-deploy
+        :link-type: ref
 
-   pyside-project.rst
+        to deploy PySide6 application as an Android app targeting different
+        Android platforms - aarch64, armv7a, i686, x86_64.