final PO review for release notes

Author: cortex-lp

content/en/blog/releases/2025.X/2025.5.md

@@ -23,7 +23,6 @@ Installation artefacts can be requested by raising a case in the [{{% ctx %}} Se
 * Observability
 * Security
 * Usability
-* Installation
 * Upgrade
 * Documentation
 
@@ -56,13 +55,14 @@ The [Security][] of {{% ctx %}} has been improved by:
 
 [Usability][] has been improved by [updating Decision Blocks icons][Updated Decision Blocks icons].
 
-[Installation][] has been modified to [improve certificate update script for High Availability (HA) installations][Improved certificate update script for High Availability (HA) installations].
+[Upgrade][] has been modified to:
 
-[Upgrade][] has been modified to [scoped restart for the {{% ctx %}} Gateway web application][Scoped restart for the {{% ctx %}} Gateway web application].
+* [improve certificate update script for High Availability (HA) installations][Improved certificate update script for High Availability (HA) installations].
+* [scoped restart for the {{% ctx %}} Gateway web application][Scoped restart for the {{% ctx %}} Gateway web application].
 
-Finally, the [Documentation][] includes updates related to:
+Finally, the [Documentation][] includes the following updates:
 
-* [added new User Guides][Added new User Guides] and [Tutorials][Added new Tutorials] for the following:
+* [added new User Guides][Added new User Guides] and [Tutorials][Added new Tutorials]:
   * Flow Editor
   * Operations Overview
   * Studio Authorisation
@@ -91,9 +91,9 @@ Finally, the [Documentation][] includes updates related to:
 | <nobr>&nbsp; &nbsp; > [{{% ctx %}} Provisioning Service][] </nobr>             | 15.0.10.25260 | Yes     | Patch         | N/A             |        |
 | <nobr>&nbsp; &nbsp; > [{{% ctx %}} Scheduling Service][] </nobr>               | 8.0.10.25260  | Yes     | Patch         | N/A             |        |
 | <nobr>&nbsp; &nbsp; > [{{% ctx %}} Triggers Service][] </nobr>                 | 12.2.2.25260  | Yes     | Minor         | N/A             |        |
-| <nobr>[{{% ctx %}} Innovation Execution Application][] </nobr>                 | 27.3.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the contract for the Debug API are [breaking][Breaking - ] between 2025.3 and 2025.5 if upgraded on its own.    |
-| <nobr>&nbsp; &nbsp; > [{{% ctx %}} Execution Service][] </nobr>                | 27.3.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the contract for the Debug API are [breaking][Breaking - ] between 2025.3 and 2025.5 if upgraded on its own.    |
-| <nobr>[{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] </nobr> | 13.5.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the contract for the Debug API are [breaking][Breaking - ] between 2025.3 and 2025.5 if upgraded on its own.    |
+| <nobr>[{{% ctx %}} Innovation Execution Application][] </nobr>                 | 27.3.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the Code Analyser that restricts what C# code can be executed from flows within CORTEX and is [breaking][Breaking - Introduced Code Analyser to the {{% ctx %}} Execution Service] between 2025.3 and 2025.5. |
+| <nobr>&nbsp; &nbsp; > [{{% ctx %}} Execution Service][] </nobr>                | 27.3.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the Code Analyser that restricts what C# code can be executed from flows within CORTEX and is [breaking][Breaking - Introduced Code Analyser to the {{% ctx %}} Execution Service] between 2025.3 and 2025.5. |
+| <nobr>[{{% ctx %}} Gateway][Gateway], including [{{% ctx %}} Studio][] </nobr> | 13.5.0.25260  | Yes     | Major         | Yes             | Major changes occurred between releases, these changes are related to the Code Analyser that restricts what C# code can be executed from flows within CORTEX and is [breaking][Breaking - Introduced Code Analyser to the {{% ctx %}} Execution Service] between 2025.3 and 2025.5. |
 | <nobr>[{{% ctx %}} Blocks Package][Blocks] </nobr>                             | 48.5.1.25260  | Yes     | Minor         | N/A             |        |
 | <nobr>[{{% ctx %}} Interaction Portal][Interaction Portal] </nobr>             | 3.2.0.25260   | Yes     | Minor         | N/A             |        |
 | <nobr>{{% ctx %}} App Server Install Scripts </nobr>                           | 5.2.11.25260  | Yes     | Patch         | N/A             |        |
@@ -336,7 +336,7 @@ Affected Components:
 
 <!-- 	Cortex\2025 Q2 S4	 - 	PBI	 - 	34660	 - 	CORTEX Blocks - Decision Blocks - Icons easier to identify	 -->
 
-#### Installation
+#### Upgrade
 
 ##### Improved certificate update script for High Availability (HA) installations
 
@@ -346,12 +346,6 @@ Affected Components:
 
 * {{% ctx %}} Upgrade Scripts
 
-<!-- TODO: discuss with PO to put to upgrade -->
-
-<!-- 	Cortex\2025 Q2 S2	 - 	PBI	 - 	20328	 - 	Installation - Certificate update is not HA	 -->
-
-#### Upgrade
-
 ##### Scoped restart for the {{% ctx %}} Gateway web application
 
 The {{% ctx %}} Gateway upgrade now stops and starts the AppPool associated with the web application rather than performing an `iisreset`. This is to prevent any downtime for other web applications running under IIS on the same server.
@@ -496,29 +490,32 @@ Affected Components:
 ### Deprecated Features
 
 There are no features deprecated as part of the 2025.5 release of the {{% ctx %}} Platform.
-<!-- TODO -->
 
 ### Removed Features
 
 There are no features removed in the 2025.5 release of the {{% ctx %}} Platform.
-<!-- TODO -->
 
 ### Potential Breaking Changes
 
-The following may potentially break interactions with the {{% ctx %}} Platform:
-
-<!-- TODO -->
+There are no known potential breaking changes as part of the 2025.5 release of the {{% ctx %}} Platform.
 
 ### Breaking Changes
 
-There are no known breaking changes as part of the 2025.5 release of the {{% ctx %}} Platform.
-<!-- TODO -->
+The following features have introduced breaking changes in the 2025.5 release of the {{% ctx %}} Platform:
 
-### Known Limitations
+#### Introduced Code Analyser to the {{% ctx %}} Execution Service
 
-Known limitations have been added within the 2025.5 release of the {{% ctx %}} Platform:
+The [Code Analyser feature][] has change  has changed what C# code can be executed from flows within {{% ctx %}}. This is a breaking change as it will prevent existing flows from being executed unless the Code Analyser is disabled or the Allowed list is updated to include the C# data types and namespaces required by new or existing flows.  
+
+To disable the Code Analyser, or to update the Allowed list, please refer to the following:
+| Disable Code Analyser                                 | Update Allowed list                                 |
+|-------------------------------------------------------|-----------------------------------------------------|
+| [Single Server][Disable Code Analyser - Single Node]  | [Single Server][Update Allowed list - Single Node]  |
+| [Multiple Server][Disable Code Analyser - Multi Node] | [Multiple Server][Update Allowed list - Multi Node] |
+
+### Known Limitations
 
-<!-- TODO -->
+There are no known limitations added as part of the 2025.5 release of the {{% ctx %}} Platform.
 
 ## Version Support
 
@@ -566,14 +563,14 @@ Known limitations have been added within the 2025.5 release of the {{% ctx %}} P
 
 ## Install Instructions
 
-If you are installing a new 2025.5 platform or adding it to an existing 7.2 Installation see the guidance below; otherwise, if you are upgrading from an existing 2025.3 platform refer to the [Upgrade Instructions][].
+If you are installing a new 2025.5 platform or adding it to an existing {{% ctx %}} 7 Installation see the guidance below; otherwise, if you are upgrading from an existing 2025.3 platform refer to the [Upgrade Instructions][].
 
 Installing {{% ctx %}} Only:
 
 * [Multiple Server - With HA][Innovation Only - Multiple Server - With HA]
 * [Single Server - Without HA][Innovation Only - Single Server - Without HA]
 
-Adding {{% ctx %}} to a 7.2 Installation:
+Adding {{% ctx %}} to a {{% ctx %}} 7 Installation:
 
 * [Multiple Server - With HA][Adding Innovation to a 7.2 Installation - Multiple Server - With HA]
 * [Single Server - Without HA][Adding Innovation to a 7.2 Installation - Single Server - Without HA]
@@ -675,6 +672,7 @@ Releases are currently forecast to be made available on:
 [Added new Tutorials]: {{< ref "#added-new-tutorials" >}}
 [Added Installation Checklists to the Install instructions]: {{< ref "#added-installation-checklists-to-the-install-instructions" >}}
 [Added Disaster Recovery Guides]: {{< ref "#added-disaster-recovery-guides" >}}
+[Code Analyser feature]: {{< ref "#introduced-code-analyser-to-the-cortex-execution-service" >}}
 
 [Upgrade Instructions]: {{< ref "#upgrade-instructions" >}}
 
@@ -690,7 +688,7 @@ Releases are currently forecast to be made available on:
 
 [Upgrade - Single Server - Without HA]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2024.11to2025.1.SingleServerWithoutHA.MainDoc" version="2025.5" >}}
 [Upgrade - Multiple Server - With HA]: {{< url path="Cortex.Guides.UpgradeGuides.UpgradeCortex.2024.11to2025.1.MultipleServerWithHA.MainDoc" version="2025.5" >}}
-[Breaking - Something]: {{< ref "#redesigned-semaphore-api-1" >}}
+[Breaking - Introduced Code Analyser to the {{% ctx %}} Execution Service]: {{< ref "#introduced-code-analyser-to-the-cortex-execution-service-1" >}}
 
 [{{% ctx %}} Studio]: {{< url path="Cortex.Guides.Studio.MainDoc" version="2025.5" >}}