Changes following 2nd PO review

Author: Donna-Marie Smith

content/en/docs/2025.1/Guides/cortex-gateway/_index.md

@@ -2,7 +2,7 @@
 title: "CORTEX Gateway"
 linkTitle: "CORTEX Gateway"
 description: "The centralised web-based portal for accessing all user applications and tooling in the {{% ctx %}} platform."
-weight: 1
+weight: 50
 ---
 
 {{< workinprogress >}}

content/en/docs/2025.1/Guides/upgrade-guides/_index.md

@@ -2,5 +2,5 @@
 title: "Upgrade Guides"
 linkTitle: "Upgrade Guides"
 description: "This section includes all upgrade guides for the {{% ctx %}} platform."
-weight: 100
+weight: 25
 ---

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

@@ -1,7 +1,7 @@
 ---
 title: "Overview"
 linkTitle: "Overview"
-description: "Summary and Anatomy of Package Management"
+description: "Summary and anatomy of Package Management"
 weight: 1
 ---
 
@@ -41,11 +41,11 @@ The [Package Version Editor][] contains the following tabs:
 
 ### Related Concepts
 
-[What is a Package?][]
+* [What is a Package?][]
 
 ### Related Tutorials
 
-[Package Management][]
+* [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" >}}

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

@@ -1,7 +1,7 @@
 ---
 title: "Package Definitions Grid"
 linkTitle: "Package Definitions Grid"
-description: "Package Definitions Grid - To be refined"
+description: "Summary and anatomy of the Package Definitions Grid"
 weight: 10
 ---
 
@@ -31,7 +31,9 @@ The Package Name must be unique and can only contain alphanumeric characters, hy
 
 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.
+The package may optionally [define LDAP groups][Authorisation] that can execute flows, [schedules][] to run flows at specific times, and [triggers][] to run flows on receipt of specific SNMP Traps.
+
+See the [Create a Package tutorial][] for a step-by-step guide.
 
 ### Import a Package
 
@@ -41,6 +43,8 @@ If the imported package already exists in {{% ctx %}} Gateway, a new version of
 
 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.
 
+See the [Import a Package tutorial][] for a step-by-step guide.
+
 ## Remarks
 
 ### Known Limitations
@@ -51,16 +55,19 @@ All the flows contained in the package will be saved in the Master Repository of
 
 ### Related Concepts
 
-[What is a Package?][]
+* [What is a Package?][]
 
 ### Related Tutorials
 
-* [Create a New {{% ctx %}} Package Definition][]
-* [Import a {{% ctx %}} Package File][]
+* [Create a Package][Create a Package tutorial]
+* [Import a Package][Import a Package tutorial]
 
 [Create a Package]: {{< ref "#create-a-package" >}}
-[Create a New {{% ctx %}} Package Definition]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.CreatePackage" >}}
-[Import a {{% ctx %}} Package File]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.ImportPackage" >}}
+[Create a Package tutorial]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.CreatePackage" >}}
+[Authorisation]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Authorisation" >}}
 [Import a Package]: {{< ref "#import-a-package" >}}
+[Import a Package tutorial]: {{< url path="Cortex.Tutorials.Administration.PackageManagement.ImportPackage" >}}
 [Package Version Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.MainDoc" >}}
+[schedules]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Schedules" >}}
+[triggers]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.Packages.PackageVersionEditor.Triggers" >}}
 [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-version-editor.md

@@ -1,7 +1,7 @@
 ---
 title: "Package Version Editor"
 linkTitle: "Package Version Editor"
-description: "Package Version Editor - To be refined"
+description: "Summary and anatomy of the Package Version Editor"
 weight: 30
 ---
 

content/en/docs/2025.1/Tutorials/Administration/package-management.md

@@ -5,50 +5,50 @@ description: "This section includes tutorials about managing packages on the {{%
 weight: 1
 ---
 
-## How to Create a New {{% ctx %}} Package
+## Create a Package
 
 {{< scribe title="How_to_Create_a_New_CORTEX_Package_Definition" id="T_4G1ik0QPmBX9Za6m4WsA" >}}
 
-## How to Import a CORTEX Package File
+## Import a Package
 
 {{< scribe title="How_to_Import_a_CORTEX_Package_File" id="2uhQbG_rTomCCVJTcCjN8A" >}}
 
-## How to Create a New Version of a CORTEX Package
+## Create a New Package Version
 
 {{< scribe title="How_to_Create_a_New_Version_of_a_CORTEX_Package" id="D9ugVBuYQiiialecvXbVVQ" >}}
 
-## How to Publish a CORTEX Package
+## Publish a Package Version
 
 {{< scribe title="How_to_Publish_a_CORTEX_Package" id="1Qd2iu1RRpKyoCCzzf6wpQ" >}}
 
-## How to Set the Default Package
+## Set the Default Package
 
 {{< scribe title="How_to_Set_the_Default_Package" id="XS8ged-jSKC7gR4UXAKPgQ" >}}
 
-## How to Set the Default Package Version for a CORTEX Package
+## Set the Default Package Version
 
 {{< scribe title="How_to_Set_the_Default_Package_Version_for_a_CORTEX_Package" id="cfuXBngKRkmSPdA81juTbA" >}}
 
-## How to Unpublish a CORTEX Package
+## Unpublish a Package Version
 
 {{< scribe title="How_to_Unpublish_a_CORTEX_Package" id="gl8v5p__R3OlB8oLB9m28w" >}}
 
-## How to Export a CORTEX Package Version
+## Export a Package Version
 
 {{< scribe title="How_to_Export_a_CORTEX_Package_Version" id="roziXdU1TqST2d9a2IDOxA" >}}
 
-## How to Set Flow Execution Authorisation on a CORTEX Package
+## Set Authorisation on a Package Version
 
 {{< scribe title="How_to_Set_Flow_Execution_Authorisation_on_a_CORTEX_Package" id="s9ZN9efvTrCgJQQH2aTGsw" >}}
 
-## How to Create a Schedule on a CORTEX Package
+## Create a Schedule on a Package Version
 
 {{< scribe title="How_to_Create_a_Schedule_on_a_CORTEX_Package" id="PmxB9BveTb6DIqhaI4AWTA" >}}
 
-## How to Create a Trigger on a CORTEX Package
+## Create a Trigger on a Package Version
 
 {{< scribe title="How_to_Create_a_Trigger_on_a_CORTEX_Package" id="z6CwThFVTHSRdL1mAMFPsQ" >}}
 
-## How to View and Abort Running Flow Executions
+## View and Abort Running Flow Executions
 
 {{< scribe title="How_to_View_and_Abort_Running_Flow_Executions_Using_CORTEX_Package_Management" id="Dgi3cpo4TZ-G426w6GEkUQ" >}}

data/urls.toml

@@ -753,8 +753,8 @@
                                 Publish = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#publish-a-package-version"
                                 RunningExecutions = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#running-executions"
                                 Schedules = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#schedules"
-                                SetDefaultPackage = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#set-default-package"
-                                SetDefaultVersion = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#set-default-package-version"
+                                SetDefaultPackage = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#set-as-default-package"
+                                SetDefaultVersion = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#set-as-default-version"
                                 Triggers = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#triggers"
                                 Unpublish = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#unpublish-a-package-version"
 
@@ -2581,18 +2581,18 @@
             MainDoc = "/docs/tutorials/administration"
             [Cortex.Tutorials.Administration.PackageManagement]
                 MainDoc = "/docs/tutorials/administration/package-management"
-                    Authorisation = "/docs/tutorials/administration/package-management/#how-to-set-flow-execution-authorisation-on-a-cortex-package"
-                    CreateNewPackageVersion = "/docs/tutorials/administration/package-management/#how-to-create-a-new-version-of-a-cortex-package"
-                    CreatePackage = "/docs/tutorials/administration/package-management/#how-to-create-a-new-cortex-package-definition"
-                    ExportPackage = "/docs/tutorials/administration/package-management/#how-to-export-a-cortex-package-version"
-                    ImportPackage = "/docs/tutorials/administration/package-management/#how-to-import-a-cortex-package-File"
-                    PublishPackage = "/docs/tutorials/administration/package-management/#how-to-publish-a-cortex-package"
-                    RunningExecutions = "/docs/tutorials/administration/package-management/#how-to-view-and-abort-running-executions"
-                    Schedules = "/docs/tutorials/administration/package-management/#how-to-create-a-Schedule-on-a-cortex-package"
-                    SetDefaultPackage = "/docs/tutorials/administration/package-management/#how-to-set-the-default-package"
-                    SetDefaultPackageVersion = "/docs/tutorials/administration/package-management/#how-to-set-the-default-package-version-for-a-cortex-package"
-                    Triggers = "/docs/tutorials/administration/package-management/#how-to-create-a-trigger-on-a-cortex-package"
-                    UnpublishPackage = "/docs/tutorials/administration/package-management/#how-to-unpublish-a-cortex-package"
+                    Authorisation = "/docs/tutorials/administration/package-management/#set-authorisation-on-a-package-version"
+                    CreateNewPackageVersion = "/docs/tutorials/administration/package-management/#create-a-new-version-of-a-cortex-package"
+                    CreatePackage = "/docs/tutorials/administration/package-management/#create-a-package"
+                    ExportPackage = "/docs/tutorials/administration/package-management/#export-a-package-version"
+                    ImportPackage = "/docs/tutorials/administration/package-management/#import-a-package"
+                    PublishPackage = "/docs/tutorials/administration/package-management/#publish-a-package-version"
+                    RunningExecutions = "/docs/tutorials/administration/package-management/#view-and-abort-running-executions"
+                    Schedules = "/docs/tutorials/administration/package-management/#create-a-Schedule-on-a-package-version"
+                    SetDefaultPackage = "/docs/tutorials/administration/package-management/#set-the-default-package"
+                    SetDefaultPackageVersion = "/docs/tutorials/administration/package-management/#set-the-default-package-version"
+                    Triggers = "/docs/tutorials/administration/package-management/#create-a-trigger-on-a-package-version"
+                    UnpublishPackage = "/docs/tutorials/administration/package-management/#unpublish-a-package-version"
 
     [Cortex.Website]
         [Cortex.Website.EngageWithUs]