Feature/add additional admin user guides (#216)

Author: Cortex-DMS

assets/scss/_content.scss

@@ -185,12 +185,11 @@
     }
 
     >.scribe-video {
-        max-width: 640px;
         width: 100%;
         animation: fadeIn 2s;
 
         iframe {
-            height: 640px;
+            height: 700px;
             width: 100%;
             aspect-ratio: 16 / 9;
             border-radius: 5px;

content/en/docs/2025.3/Guides/cortex-gateway/settings/license-consumption.md

@@ -0,0 +1,63 @@
+---
+title: "License Consumption"
+linkTitle: "License Consumption"
+description: "View the license consumption in {{% ctx %}} Gateway."
+weight: 80
+---
+
+# {{% param title %}}
+
+## Summary
+
+The License Consumption page is used to view the license consumption for the current platform and the minimum license requirement to support the current usage.
+
+## Anatomy
+
+{{< figure src="/images/License Consumption.png" title="License Consumption" >}}
+
+## Actions
+
+### View License Consumption
+
+Every functional block connected to a Start Flow block adds one to the license consumption, except for the following blocks, which do not impact the license consumption:
+
+* [Start Flow][]
+* [End Flow][]
+* [Start Workspace][]
+* [End Workspace][]
+* [Wireless Receiver][]
+* [Wireless Sender][]
+* [Workspace][]
+* [Handle Flow Exception Workspace][]
+
+The License Consumption details are shown in a tabular format, where each flow’s license consumption is aggregated and shown as a total against its parent group. Groups may be expanded to show the license consumption of each individual flow.
+
+The `Breakdown` switch expands the table to additionally show the flow usage and the number of functional blocks used in each flow. In {{% ctx %}} all flows will have a count of 1 in the `Usage` column.
+
+See the [Check License Consumption][Check License Consumption tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+None
+
+## See Also
+
+### Related Concepts
+
+None
+
+### Related Tutorials
+
+* [Check License Consumption][Check License Consumption tutorial]
+
+[Check License Consumption tutorial]: {{< url path="Cortex.Tutorials.Administration.LicenseConsumption.CheckLicenseConsumption" >}}
+[End Flow]: {{< url path="Cortex.Reference.Blocks.Flows.EndFlow.EndFlow.MainDoc" >}}
+[End Workspace]: {{< url path="Cortex.Reference.Blocks.Workspaces.EndWorkspace.EndWorkspace.MainDoc" >}}
+[Handle Flow Exception Workspace]: {{< url path="Cortex.Reference.Blocks.Exceptions.HandleFlow.HandleFlowException.MainDoc" >}}
+[Start Flow]: {{< url path="Cortex.Reference.Blocks.Flows.StartFlow.StartFlow.MainDoc" >}}
+[Start Workspace]: {{< url path="Cortex.Reference.Blocks.Workspaces.StartWorkspace.StartWorkspace.MainDoc" >}}
+[Wireless Receiver]: {{< url path="Cortex.Reference.Blocks.Wireless.WirelessReceiver.WirelessReceiver.MainDoc" >}}
+[Wireless Sender]: {{< url path="Cortex.Reference.Blocks.Wireless.WirelessSender.WirelessSender.MainDoc" >}}
+[Workspace]: {{< url path="Cortex.Reference.Blocks.Workspaces.Workspace.Workspace.MainDoc" >}}

content/en/docs/2025.3/Guides/cortex-gateway/settings/studio-authorisation.md

@@ -0,0 +1,101 @@
+---
+title: "Studio Authorisation"
+linkTitle: "Studio Authorisation"
+description: "Configure access to flows in {{% ctx %}} Gateway."
+weight: 50
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Studio Authorisation page is used to configure access to flows within {{% ctx %}} Gateway. Each flow can be set to have [`View`][View] or [`Edit`][Edit] permissions assigned to LDAP Groups that exist in the Active Directory server configured in LDAP Connection for {{% ctx %}} Gateway, or no access permissions at all.
+
+|                              |                                                                 |
+|------------------------------|-----------------------------------------------------------------|
+| **Roles Required:**          | Admin                                                           |
+
+## Anatomy
+
+{{< figure src="/images/Studio Authorisation.png" title="Studio Authorisation" >}}
+
+The LDAP Groups that may be granted access are limited to those assigned the `Studio` role in LDAP Authorisation.
+
+Permissions are set either explicitly or implicitly. Explicitly set permissions are assigned by the user performing an explicit action to set that item’s permissions, whereas implicitly set permissions are assigned automatically by the user explicitly setting the permissions on a parent group.
+
+Permissions are explicitly set by setting the checkbox in either the [View][] or [Edit][] columns of the appropriate LDAP Group for the flow or group to which the permissions are to be assigned.  Permissions are explicitly removed by clearing the checkbox.
+
+If an item is explicitly set with [`Edit`][Edit] permissions, then that item will also be implicitly set with [`View`][View] permissions. Explicitly setting an item with [`View`][View] permissions does not implicitly set it with Edit permissions.
+
+## Actions
+
+### View
+
+If an LDAP group is given `View` permissions on a flow, the members of the LDAP group can:
+
+* View the flow
+* Debug the flow
+
+If an LDAP Group is given `View` permissions on a group, the members of that LDAP group can:
+
+* View all descendent groups and flows
+* Debug all descendent flows
+
+If a group has `View` permissions either explicitly set or implicitly set, then its child groups and flows will have their `View` permissions implicitly set.
+
+If a group has its `View` permissions removed, then all its child groups and flows will have their `View` permissions removed, regardless of whether they were set explicitly or implicitly.
+
+See the [Manage Flow Access][Manage Flow Access tutorial] tutorial for a step-by-step guide.
+
+### Edit
+
+If an LDAP group is given `Edit` permissions on a flow, the members of the LDAP group can:
+
+* View the flow
+* Debug the flow
+* Edit the flow
+* Move the flow
+* Rename the flow
+* Delete the flow
+* Commit changes to the flow
+* Get the master version of the flow
+
+If an LDAP Group is given `Edit` permissions on a group, the members of that LDAP group can:
+
+* Create new flows and groups within the group
+* View all descendent flows and groups
+* Debug all descendent flows
+* Edit all descendent flows
+* Move all descendent flows
+* Rename all descendent flows
+* Delete all descendent flows
+* Commit changes to all descendent flows
+* Get the master version of all descendent flows
+
+If a group has `Edit` permissions explicitly set, then its child groups and flows will be implicitly set with both `Edit` and [`View`][View] permissions.
+
+If a group has its `Edit` permissions removed, then all its child groups and flows will have their `Edit` permissions removed, regardless of whether they were set explicitly or implicitly.
+
+If a flow is explicitly set with `Edit` permissions, then any parent groups, which have not been explicitly set with [`View`][View] permissions, will be implicitly set with [`View`][View] permissions.
+
+See the [Manage Flow Access][Manage Flow Access tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+* The state of whether a permission is granted explicitly or implicitly is not persisted between the page being closed and reopened.
+
+## See Also
+
+### Related Concepts
+
+None
+
+### Related Tutorials
+
+* [Manage Flow Access][Manage Flow Access tutorial]
+
+[Edit]: {{< ref "#edit">}}
+[View]: {{< ref "#view">}}
+[Manage Flow Access tutorial]: {{< url path="Cortex.Tutorials.Administration.StudioAuthorisation.ManageFlowAccess" >}}

content/en/docs/2025.3/Guides/cortex-gateway/settings/studio-hierarchy.md

@@ -2,7 +2,7 @@
 title: "Studio Export"
 linkTitle: "Studio Export"
 description: "Export flows from {{% ctx %}} Gateway."
-weight: 50
+weight: 60
 ---
 
 # {{% param title %}}

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/Admin/license-consumption.md

@@ -0,0 +1,49 @@
+---
+title: "Studio Hierarchy"
+linkTitle: "Studio Hierarchy"
+description: "Move flows in {{% ctx %}} Gateway."
+weight: 70
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Studio Hierarchy page is used to move one or more flows from one group to another.
+
+## Anatomy
+
+{{< figure src="/images/Studio Hierarchy.png" title="Studio Hierarchy" >}}
+
+Only flows with [`Edit`][Edit] permissions for the current user are displayed in the Studio Hierarchy grid.
+
+## Actions
+
+### Move Flows
+
+After selecting the flows that are to be moved, right-click on the group where the selected flows will be moved to, and select the `Move selected items to this Group` from the context menu. The display will be updated to show the resultant hierarchy, with the flows to be moved but not yet committed identified with an asterisk (*) in the `Results` column of the grid.
+
+If a group is selected, then only the flows contained in that group are moved to another group; not the group itself.
+
+Once all the necessary flows have been moved, the changes can be committed using the `Commit` button.
+
+See the [Manage Flow Hierarchy][Manage Flow Hierarchy tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+* Parent groups must also have [`Edit`][Edit] permissions, in addition to the flows, otherwise the group and flows contained within it will not be displayed.
+
+## See Also
+
+### Related Concepts
+
+None
+
+### Related Tutorials
+
+* [Manage Flow Hierarchy][Manage Flow Hierarchy tutorial]
+
+[Edit]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation.Edit" >}}
+[Manage Flow Hierarchy tutorial]: {{< url path="Cortex.Tutorials.Administration.StudioHierarchy.ManageFlowHierarchy" >}}

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/Admin/studio-authorisation.md

@@ -2,7 +2,7 @@
 title: "Studio Import"
 linkTitle: "Studio Import"
 description: "Import flows into {{% ctx %}} Gateway."
-weight: 25
+weight: 40
 ---
 
 # {{% param title %}}

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/Admin/studio-export.md

@@ -15,7 +15,7 @@ The Version Control page displays the flow hierarchy for the current user, indic
 
 {{< figure src="/images/Version Control.png" title="Version Control" >}}
 
-Only flows with Edit permissions for the current user are displayed in the Version Control grid.
+Only flows with [`Edit`][Edit] permissions for the current user are displayed in the Version Control grid.
 
 ## Actions
 
@@ -35,7 +35,7 @@ See the [Use Version Control][Use Version Control tutorial] tutorial for a step-
 
 ### Known Limitations
 
-* Parent groups must also have edit permissions, in addition to the flows, otherwise the group and flows contained within it will not be displayed.
+* Parent groups must also have [`Edit`][Edit] permissions, in addition to the flows, otherwise the group and flows contained within it will not be displayed.
 
 ## See Also
 
@@ -47,4 +47,5 @@ None
 
 * [Use Version Control][Use Version Control tutorial]
 
+[Edit]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation.Edit" >}}
 [Use Version Control tutorial]: {{< url path="Cortex.Tutorials.Administration.VersionControl.UseVersionControl" >}}