[Bf-docboard-svn] bf-manual: [7718] branches/blender-2.92-release/blender_docs/manual/interface/controls/nodes/groups.rst: Cleanup: Reorder group node content

[Aaron Carlisle]

Revision: 7718
          https://developer.blender.org/rBM7718
Author:   Blendify
Date:     2021-02-04 05:20:43 +0100 (Thu, 04 Feb 2021)
Log Message:
-----------
Cleanup: Reorder group node content

Modified Paths:
--------------
    branches/blender-2.92-release/blender_docs/manual/interface/controls/nodes/groups.rst

Modified: branches/blender-2.92-release/blender_docs/manual/interface/controls/nodes/groups.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/interface/controls/nodes/groups.rst	2021-02-03 23:03:34 UTC (rev 7717)
+++ branches/blender-2.92-release/blender_docs/manual/interface/controls/nodes/groups.rst	2021-02-04 04:20:43 UTC (rev 7718)
@@ -30,6 +30,73 @@
    A node group can never contain itself (or another group that contains it).
 
 
+Interface
+=========
+
+When a node group is created, new *Group Input* and *Group Output* nodes are generated
+to represent the data flow into and out of the group. When created, connections to input sockets coming
+from unselected nodes will become attached to new sockets on the *Group Input* node.
+Similarly, outgoing connections to input sockets of unselected nodes will become attached to
+the new *Group Output* node.
+
+If during node group development an additional parameter needs to be passed into the group,
+an additional socket must be added to the *Group Input* node.
+This is easily done by adding a connection from the hollow socket on the right side of the *Group Input* node
+to the desired input socket on the node requiring input.
+The process is similar for the *Group Output* regarding data
+you want to be made available outside the group.
+
+
+Panel
+-----
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      All Modes
+   :Panel:     :menuselection:`Sidebar --> Node --> Interface`
+
+.. figure:: /images/interface_controls_nodes_groups_interface-panel.png
+   :align: right
+
+   The interface panel for editing groups.
+
+Sockets can be added, re-ordered, or removed, descriptive names can be added and
+the details of the input data value defined here.
+
+If you have multiple inputs or outputs, they can be re-ordered by selecting the socket in the list
+and then moving it up or down with the arrow buttons on the right side of the panel.
+The larger plus sign buttons below the list will add an unconnected socket of the same type
+as the selected socket or a value socket if there is no selection.
+The triangle at the bottom of the list has filtering functions to facilitate finding nodes
+if the group has a large number of sockets.
+
+
+.. _bpy.ops.node.tree_path_parent:
+
+Edit Group
+==========
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      All Modes
+   :Menu:      :menuselection:`Node --> Edit Group`
+   :Header:    :menuselection:`Go to Parent Node Tree`
+   :Hotkey:    :kbd:`Tab`, :kbd:`Ctrl-Tab`
+
+With a node group selected, :kbd:`Tab` expands the node to a frame, and the individual nodes within
+it are shown. You can move them around, play with their individual controls, re-thread them internally, etc.
+just like you can if they were a normal part of the editor view. You will not be able, though,
+to thread them to a node outside the group; you have to use the external sockets on the side of the node group.
+While :kbd:`Tab` can be used to both enter and exit a group, :kbd:`Ctrl-Tab` only exits.
+
+.. figure:: /images/render_cycles_optimizations_reducing-noise_glass-group.png
+   :width: 620px
+
+   Example of an expanded node group.
+
+
 .. _bpy.ops.node.group_make:
 
 Make Group
@@ -74,7 +141,7 @@
    :class: refbox
 
    :Mode:      All Modes
-   :Menu:      :menuselection:`Group --> Ungroup`
+   :Menu:      :menuselection:`Node --> Ungroup`
    :Hotkey:    :kbd:`Ctrl-Alt-G`
 
 The :kbd:`Ctrl-Alt-G` tool removes the group and places the individual nodes into your editor workspace.
@@ -89,76 +156,8 @@
       Move to parent node tree, remove from group.
 
 
-.. _bpy.ops.node.tree_path_parent:
+.. _bpy.ops.node.group_insert:
 
-Edit Group
-==========
-
-.. admonition:: Reference
-   :class: refbox
-
-   :Mode:      All Modes
-   :Menu:      :menuselection:`Node --> Edit Group`
-   :Header:    :menuselection:`Go to Parent Node Tree`
-   :Hotkey:    :kbd:`Tab`, :kbd:`Ctrl-Tab`
-
-With a node group selected, :kbd:`Tab` expands the node to a frame, and the individual nodes within
-it are shown. You can move them around, play with their individual controls, re-thread them internally, etc.
-just like you can if they were a normal part of the editor view. You will not be able, though,
-to thread them to a node outside the group; you have to use the external sockets on the side of the node group.
-While :kbd:`Tab` can be used to both enter and exit a group, :kbd:`Ctrl-Tab` only exits.
-
-.. figure:: /images/render_cycles_optimizations_reducing-noise_glass-group.png
-   :width: 620px
-
-   Example of an expanded node group.
-
-
-Interface
----------
-
-Interactively
-^^^^^^^^^^^^^
-
-When a node group is created, new *Group Input* and *Group Output* nodes are generated
-to represent the data flow into and out of the group. When created, connections to input sockets coming
-from unselected nodes will become attached to new sockets on the *Group Input* node.
-Similarly, outgoing connections to input sockets of unselected nodes will become attached to
-the new *Group Output* node.
-
-If during node group development an additional parameter needs to be passed into the group,
-an additional socket must be added to the *Group Input* node.
-This is easily done by adding a connection from the hollow socket on the right side of the *Group Input* node
-to the desired input socket on the node requiring input.
-The process is similar for the *Group Output* regarding data
-you want to be made available outside the group.
-
-
-Panel
-^^^^^
-
-.. admonition:: Reference
-   :class: refbox
-
-   :Mode:      All Modes
-   :Panel:     :menuselection:`Sidebar region --> Node --> Interface`
-
-.. figure:: /images/interface_controls_nodes_groups_interface-panel.png
-   :align: right
-
-   The interface panel for editing groups.
-
-Sockets can be added, re-ordered, or removed, descriptive names can be added and
-the details of the input data value defined here.
-
-If you have multiple inputs or outputs, they can be re-ordered by selecting the socket in the list
-and then moving it up or down with the arrow buttons on the right side of the panel.
-The larger plus sign buttons below the list will add an unconnected socket of the same type
-as the selected socket or a value socket if there is no selection.
-The triangle at the bottom of the list has filtering functions to facilitate finding nodes
-if the group has a large number of sockets.
-
-
 Group Insert
 ============