Interface customization: menus and toolbars

Author: selmaVH1

docs/user_manual/introduction/img/customization.png

@@ -2406,11 +2406,10 @@ Customization
 =============
 
 The :guilabel:`Customization` dialog lets you (de)activate almost every element in the QGIS
-user interface. This can be very useful if you want to provide your end-users with a
-'light' version of QGIS, containing only the icons, menus or panels they need.
+user interface, and create your own custom toolbars and menus. This can be very useful if you
+want to provide your end-users with a 'light' version of QGIS, containing only the icons, menus
+or panels they need, or a focused workspace built around a specific set of actions.
 
-.. note::
-   Before your changes are applied, you need to restart QGIS.
 
 .. _figure_customization:
 
@@ -2431,6 +2430,17 @@ The configurable item can be:
 * a **Toolbar**: the whole bar or some of its icons
 * or any **widget** from any dialog in QGIS: label, button, combobox...
 
+In addition to showing or hiding existing interface elements, you can also create
+user-defined toolbars and menus. To do so, select the :guilabel:`Menus` or
+:guilabel:`Toolbars` item in the customization tree and click the |add| :sup:`Add a user defined menu or toolbar`
+button. To populate it with actions, open the action panel by clicking the
+|listActions| button, search for the desired actions and drag and drop them onto
+the user-defined menu or toolbar in the customization tree. Items within user-defined
+toolbars and menus can be reordered using drag and drop.
+
+To remove a user-defined toolbar or menu, select it and click the |deleteSelected|
+:sup:`Delete selected item` button.
+
 With |select| :sup:`Switch to catching widgets in main application`, you
 can click on an item in QGIS interface that you want to be hidden and
 QGIS automatically unchecks the corresponding entry in the Customization dialog.
@@ -2439,10 +2449,10 @@ You can also use the :guilabel:`Search` box to find items by their name or label
 Once you setup your configuration, click :guilabel:`Apply` or :guilabel:`OK` to validate your
 changes. This configuration becomes the one used by default by QGIS at the next startup.
 
-The modifications can also be saved in a ``.ini`` file using |fileSave|
+The modifications can also be saved in a ``.xml`` file using |fileSave|
 :sup:`Save To File` button. This is a handy way to share a common QGIS
 interface among multiple users. Just click on |fileOpen| :sup:`Load from File`
-from the destination computer in order to import the ``.ini`` file.
+from the destination computer in order to import the ``.xml`` file.
 You can also run :ref:`command line tools <custom_commandline>` and save various
 setups for different use cases as well.
 
@@ -2923,6 +2933,8 @@ in the QGIS user profile.
    :width: 1.5em
 .. |action| image:: /static/common/action.png
    :width: 2em
+.. |add| image:: /static/common/mActionAdd.png
+   :width: 1.5em
 .. |checkbox| image:: /static/common/checkbox.png
    :width: 1.3em
 .. |codeEditor| image:: /static/common/mIconCodeEditor.png
@@ -2967,6 +2979,8 @@ in the QGIS user profile.
    :width: 1.5em
 .. |keyboardShortcuts| image:: /static/common/mActionKeyboardShortcuts.png
    :width: 1.5em
+.. |listActions| image:: /static/common/mActionListActions.png
+   :width: 2.5em
 .. |measure| image:: /static/common/mActionMeasure.png
    :width: 1.5em
 .. |measureBearing| image:: /static/common/mActionMeasureBearing.png

docs/user_manual/introduction/qgis_configuration.rst

@@ -711,6 +711,8 @@
    :width: 2.5em
 .. |linkQGisToGeoref| image:: /static/common/mActionLinkQGisToGeoref.png
    :width: 2.5em
+.. |listActions| image:: /static/common/mActionListActions.png
+   :width: 2.5em
 .. |loadGCPpoints| image:: /static/common/mActionLoadGCPpoints.png
    :width: 1.5em
 .. |localCRS| replace:: ``WGS 84 / UTM 34S``