Add Azure Service Bus upgrade guide for v5 to v6 (#7831)

* Add Azure Service Bus upgrade guide for v5 to v6

* Tweaks

---------

Co-authored-by: Brandon Ording <[email protected]>

Author: RyanThomasForge

menu/menu.yaml

@@ -832,6 +832,8 @@
         Title: Version 6 to 7
     - Title: Azure Service Bus
       Articles:
+      - Url: transports/upgrades/asbs-5to6
+        Title: Version 5 to 6
       - Url: transports/upgrades/asbs-4to5
         Title: Version 4 to 5
       - Url: transports/upgrades/asbs-3to4

transports/upgrades/asbs-1.7to1.8.md

@@ -11,7 +11,7 @@ upgradeGuideCoreVersions:
 
 ## Replacing shorteners with naming conventions
 
-For existing shoteners, the logic has to be moved into appropriate naming conventions.
+For existing shorteners, the logic has to be moved into appropriate naming conventions.
 To retain the same behavior, a length check needs to be added to the naming conventions logic.
 
 ### RuleNameShortener

transports/upgrades/asbs-1to2.md

@@ -1,6 +1,6 @@
 ---
 title: Azure Service Bus Transport Upgrade Version 1 to 2
-summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 1 to 2.
+summary: Instructions on how to upgrade Azure Service Bus transport from version 1 to 2.
 reviewed: 2022-03-25
 component: ASBS
 related:

transports/upgrades/asbs-2to3.md

@@ -1,6 +1,6 @@
 ---
 title: Azure Service Bus Transport Upgrade Version 2 to 3
-summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 2 to 3
+summary: Instructions on how to upgrade Azure Service Bus transport from version 2 to 3
 reviewed: 2021-11-07
 component: ASBS
 related:

transports/upgrades/asbs-3to4.md

@@ -1,6 +1,6 @@
 ---
 title: Azure Service Bus Transport Upgrade Version 3 to 4
-summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 3 to 4
+summary: Instructions on how to upgrade Azure Service Bus transport from version 3 to 4
 reviewed: 2023-12-12
 component: ASBS
 related:

transports/upgrades/asbs-4to5.md

@@ -1,12 +1,14 @@
 ---
 title: Azure Service Bus Transport Upgrade Version 4 to 5
-summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 4 to 5
+summary: Instructions on how to upgrade Azure Service Bus transport from version 4 to 5
 reviewed: 2025-02-07
 component: ASBS
 related:
  - transports/azure-service-bus
  - samples/azure-service-bus-netstandard/topology-migration
 isUpgradeGuide: true
+upgradeGuideCoreVersions:
+ - 9
 ---
 
 Upgrading Azure Service Bus transport from version 4 to version 5 is a major upgrade and requires careful planning. Read the entire upgrade guide before beginning the upgrade process.
@@ -226,7 +228,7 @@ static string HashName(string input)
 
 ### Migrating rule name customizations
 
-Previously, rule names could be [assigned using function delegates](/transports/azure-service-bus/configuration.md?version=asbs_4#entity-creation-settings) 
+Previously, rule names could be [assigned using function delegates](/transports/azure-service-bus/configuration.md?version=asbs_4#entity-creation-settings)
 
 ```csharp
 transport.SubscriptionRuleNamingConvention(x => "MyPrefix-"+x);

transports/upgrades/asbs-5to6.md

@@ -0,0 +1,17 @@
+---
+title: Azure Service Bus Transport Upgrade Version 5 to 6
+summary: Instructions on how to upgrade Azure Service Bus transport from version 5 to 6
+reviewed: 2025-09-18
+component: ASBS
+related:
+ - transports/azure-service-bus
+isUpgradeGuide: true
+upgradeGuideCoreVersions:
+ - 9
+ - 10
+---
+
+## Transport Encoding Header
+
+The `NServiceBus.Transport.Encoding` header is longer used, but the transport could still send it for compatibility with the legacy Azure Service Bus transport. The ability to send this header has been removed and the `SendTransportEncodingHeader` APIs to opt in to sending it have been deprecated.
+Remove all references to these APIs.