Added initial content for Package Management

Author: Donna-Marie Smith

.gitignore

@@ -1,12 +1,13 @@
-docs/
-!docs/CNAME
-public/
-resources/
+/content/en/docs/latest/
+/content/static/latest/
+/content/static/**/*.dtmp
+/content/static/**/*.bkp
+/content/static/**/*.crswap
+/content/static/lunr-index.json
+!/docs/CNAME
+/docs/
+/public/
+/resources/
 node_modules/
 tech-doc-hugo
-content/en/docs/latest/
-content/static/latest/
-content/static/**/*.dtmp
-content/static/**/*.bkp
-content/static/**/*.crswap
-content/static/lunr-index.json
+old-tutorials.md

assets/scss/_content.scss

@@ -184,6 +184,19 @@
         }
     }
 
+    >.scribe-video {
+        max-width: 640px;
+        width: 100%;
+        animation: fadeIn 2s;
+
+        iframe {
+            height: 640px;
+            width: 100%;
+            aspect-ratio: 16 / 9;
+            border-radius: 5px;
+        }
+    }
+
     br {
         content: " ";
         display: block;

content/en/docs/2025.1/Guides/user-guides/user-interfaces/gateway/Admin/packages/_index.md

@@ -1,6 +1,6 @@
 ---
 title: "Packages"
 linkTitle: "Packages"
-description: "This section includes user guides related to Packages in {{% ctx %}} Gateway."
+description: "This section includes user guides related to Package Management in {{% ctx %}} Gateway."
 weight: 10
 ---

content/en/docs/2025.1/Guides/user-guides/user-interfaces/gateway/Admin/packages/overview.md

@@ -1,26 +1,64 @@
 ---
 title: "Overview"
 linkTitle: "Overview"
-description: "Summary and Anatomy of Package Management screen - To be refined"
+description: "Summary and Anatomy of Package Management"
 weight: 1
 ---
 
 # {{% param title %}}
 
 ## Summary
-Summary of the package management page
+
+The Package Management page allows you to manage [{{% ctx %}} packages][What is a Package?], including creating and publishing them.
 
 |                              |                                                                 |
 |------------------------------|-----------------------------------------------------------------|
 | **Roles Required:**          | Admin                                                           |
 
 ## Anatomy
-Diagram of the section
+
+{{< figure src="/images/Package Management.png" title="Package Management" >}}
+
+The Package Management page displays a list of existing {{% ctx %}} Package definitions in the [Package Definitions Grid][], showing the most recently created version of each package; older versions can be viewed by expanding the package definition.
+
+Selecting a package version will display it in the [Package Version Editor][]; the Definition tab will be selected, displaying the flows it contains and buttons to:
+
+* [Export][] the selected package version to a {{% ctx %}} Package file.
+* [Create New Version][] of the package based on the selected package version.
+* [Publish][] or [Unpublish][] the package version to the {{% ctx %}} Execution Services.
+* [Set As Default Package][] enabling flows to be executed from all versions of this package without specifying the package name in the execution REST Request.
+* [Set As Default Version][] enabling flows to be executed from the package version without specifying the package version in the execution REST Request.
+
+The [Package Version Editor][] contains the following tabs:
+
+* [Definition][] - displays the flows contained in this package version.
+* [Authorisation][] - allows the selection of LDAP groups authorised to execute flows contained in this package version.
+* [Schedules][] – allows configuration of schedules to automatically execute flows contained in this package version at defined times or intervals.
+* [Triggers][] - allows configuration of SNMP triggers to automatically execute flows contained in this package version on receipt of SNMP traps.
+* [Running Executions][] - displays a list of running executions of flows in this package version and enables the user to abort them.
 
 ## See Also
 
 ### Related Concepts
-e.g. link to fundamentals/concepts to what is a??
+
+[What is a Package?][]
 
 ### Related Tutorials
-e.g. links to Scribe tutorials
+
+[Package Management][]
+
+[Authorisation]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Authorisation" >}}
+[Create New Version]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.CreateNewVersion" >}}
+[Definition]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Definition" >}}
+[Export]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Export" >}}
+[Package Definitions Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageDefinitionsGrid.MainDoc" >}}
+[Package Management]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.MainDoc" >}}
+[Package Version Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.MainDoc" >}}
+[Publish]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Publish" >}}
+[Running Executions]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.RunningExecutions" >}}
+[Schedules]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Schedules" >}}
+[Set As Default Package]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.SetDefaultPackage" >}}
+[Set As Default Version]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.SetDefaultVersion" >}}
+[Triggers]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Triggers" >}}
+[Unpublish]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Unpublish" >}}
+[What is a Package?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Packages.WhatIsAPackage.MainDoc" >}}

content/en/docs/2025.1/Guides/user-guides/user-interfaces/gateway/Admin/packages/package-definitions-grid.md

@@ -8,19 +8,59 @@ weight: 10
 # {{% param title %}}
 
 ## Summary
-Summary of the package definitions grid
+
+The Package Definitions Grid displays a list of existing [{{% ctx %}} Package][What is a Package?] definitions.
 
 ## Anatomy
-Diagram of the section
+
+{{< figure src="/images/Package Definitions Grid.png" title="Package Definitions Grid" >}}
+
+The Package Definitions Grid shows the most recently created version of each package; older versions can be viewed by expanding the package definition. Selecting a package version will display it's details in the [Package Version Editor][].
+
+The Package Definitions Grid also contains buttons to:
+* [Create a Package][]
+* [Import a Package][]
+
+## Actions
+
+### Create a Package
+
+A new package is created by clicking the `Add Package Definition` button, supplying a Package Name and selecting the flows to be included in the package.
+
+The Package Name must be unique and can only contain alphanumeric characters, hyphens and underscores. The flows added to the package definition are the Master Versions of the flows contained in the Master Repository (most recently committed flow version).
+
+If a selected flow has dependent flows, the dependent flow will be automatically selected for inclusion in the package; dependent flows cannot be manually deselected for inclusion; this ensures packages contain all required dependencies.
+
+The package may optionally define LDAP groups that can execute flows, schedules to run flows at specific times, and triggers to run flows on receipt of specific SNMP Traps.
+
+### Import a Package
+
+A {{% ctx %}} Package file, with the extension of `.ctxpkg`, may be imported into any {{% ctx %}} Gateway by clicking the `Import` button and selecting the `.ctxpkg` file to import. 
+
+If the imported package already exists in {{% ctx %}} Gateway, a new version of that package will be created; if the imported package does not exist, a new package will be created.
+
+All the flows contained in the package will be saved in the Master Repository of the destination {{% ctx %}} Gateway as the master versions of those flows; if the imported flows already existed, the imported flows would become the new master versions.
 
 ## Remarks
-e.g any specific comments that are needed e.g. if it cant communicate then warnings are displayed
+
 ### Known Limitations
-e.g document any known limitations
+
+* Flow versions other than the master versions stored in the Master Repository cannot be included in a new package.
+
 ## See Also
 
 ### Related Concepts
-e.g. link to fundamentals/concepts to what is a??
+
+[What is a Package?][]
 
 ### Related Tutorials
-e.g. links to Scribe tutorials
+
+* [How to Create a New {{% ctx %}} Package Definition][]
+* [How to Import a {{% ctx %}} Package File][]
+
+[Create a Package]: {{< ref "#create-a-package" >}}
+[How to Create a New {{% ctx %}} Package Definition]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.CreatePackage" >}}
+[How to Import a {{% ctx %}} Package File]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.ImportPackage" >}}
+[Import a Package]: {{< ref "#import-a-package" >}}
+[Package Version Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.MainDoc" >}}
+[What is a Package?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Packages.WhatIsAPackage.MainDoc" >}}