Merge pull request #9461 from Dowsley/updated-groups-tutorial

Update groups tutorial for project-wide node groups

Author: skyace65

tutorials/scripting/groups.rst

@@ -21,51 +21,52 @@ removed by removing all nodes from a given group.
 
 There are two ways to add/remove nodes to groups:
 
-- During design, by using the Node dock in the editor.
+- During design, by using the Node dock in the editor, or the Global Groups in project settings.
 - During execution, by calling :ref:`Node.add_to_group() <class_Node_method_add_to_group>`
   or :ref:`Node.remove_from_group() <class_Node_method_remove_from_group>`.
 
 
 Using the Node dock
 ~~~~~~~~~~~~~~~~~~~
 
-You can add nodes in the current scene to groups using the Groups tab in the
-Node dock.
+You can create new groups using the Groups tab in the Node dock.
 
 .. image:: img/groups_node_tab.webp
 
-Select one or more nodes in the Scene dock and write the group name in the
-field, then click Add.
+Select one or more nodes in the Scene dock then click the add button with the + symbol.
 
-.. image:: img/groups_add_node_to_group.webp
+.. image:: img/groups_add_new_group_button.webp
 
-You should now see the group appear.
+You should now see the Create New Group modal appear. Write the group name in the field.
 
-.. image:: img/groups_node_after_adding.webp
+You can optionally mark the option "Global", which will make the group visible project-wide,
+and able to be reused in any project scene. This will also allow you to give it a description.
 
-In a complex project, you may end up with many groups or large scenes with many
-nodes. You can add or remove any node to groups using the Group Editor window.
-To access it, click the Manage Groups button.
+When done, press Ok to create it.
 
-.. image:: img/groups_manage_groups_button.webp
+.. image:: img/groups_add_new_group_modal.webp
 
-The Group Editor window appears. Here's a screenshot from a complex project to
-illustrate the tool's purpose.
+You should see the new groups appear in the Groups tab under Scene Groups if the Global option was
+unmarked, or under Global Groups if that option was marked.
 
-.. image:: img/groups_group_editor_window.webp
+Selected Node(s) from the Scene dock can be added into groups by marking the checkbox on the left side
+of the groups in the Groups dock. The node(s) you had selected when creating a new group will be automatically checked.
 
-It has three columns:
+.. image:: img/groups_node_tab_with_created_groups.webp
 
-1. A list of groups used by nodes in the current scene.
-2. A list of nodes that are not part of the selected group.
-3. A list of nodes in the group.
+All groups present in the project that were marked as Global, created from any scene, will be visible under Global Groups.
 
-The fields at the bottom allow you to add new groups or filter nodes in the
-second and third columns.
+Any other group derived from nodes in the current scene will appear under Scene Groups.
 
-.. note:: Any node name that's greyed out means the node was added to the group
-          in a different scene and you cannot edit it here. This happens on
-          scene instances in particular.
+.. warning:: The same underlying logic is used for both Global and Scene groups. 
+             Groups with the same name are considered one and the same. This feature is purely organizational.
+
+.. image:: img/groups_node_tab_with_multiple_types_of_groups.webp
+
+You can manage Global Groups in the Global Groups dock, inside Project Settings. There, you will be able to add new
+global groups, or change existing groups' names and descriptions.
+
+.. image:: img/groups_global_groups_settings.webp
 
 Using code
 ~~~~~~~~~~