Update container-storage-release-notes.md

Author: khdownie

articles/storage/container-storage/container-storage-release-notes.md

@@ -4,7 +4,7 @@ description: Release notes for Azure Container Storage
 author: denisacatalinastan
 ms.service: azure-container-storage
 ms.topic: release-notes
-ms.date: 09/20/2024
+ms.date: 11/26/2024
 ms.author: dstan
 ---
 # Release notes for Azure Container Storage
@@ -26,25 +26,25 @@ The following Azure Container Storage versions are supported:
 
 The following Azure Container Storage versions are no longer supported: 1.0.6-preview, 1.0.3-preview, 1.0.2-preview, 1.0.1-preview, 1.0.0-preview. See [Upgrade a preview installation to GA](#upgrade-a-preview-installation-to-ga) for upgrading guidance.
 
-## Major vs Minor vs. Patch releases
+## Major vs. minor vs. patch releases
 
 A **major release** introduces significant changes, often including new features, architectural updates, or breaking changes; for example, moving from version 1.1.0 to 2.0.0. A **minor release** adds enhancements or new functionality that are backward-compatible, such as moving from version 1.1.0 to 1.2.0. Lastly, a **patch release** focuses on resolving critical bugs, security issues, or minor optimizations while maintaining backward compatibility, such as moving from version 1.1.1 to 1.1.2, and is intended to ensure stability and reliability without introducing new features.
 
 ## Version 1.2.0 
 
-### Improvements and issues that are fixed 
-- **Bug fixes and performance improvements**: General stability improvements have been made to address key recovery issues, especially during upgrade scenarios. These updates are designed to ensure more reliable recovery processes and prevent unexpected service interruptions, delivering a smoother and more consistent experience.  
-- **Ephemeral Disk Performance Enhancements**: We improved overall performance for Azure Container Storage with ephemeral NVMe disks as the backing storage option, delivering up to a 100% increase in write IOPS in setups with replication enabled. For more details, read about ephemeral disk performance [using local NVMe](/azure/storage/container-storage/use-container-storage-with-local-disk#optimize-performance-when-using-local-nvme) and [using local NVMe with replication](/azure/storage/container-storage/use-container-storage-with-local-nvme-replication#optimize-performance-when-using-local-nvme).
+### Improvements and issues that are fixed
 
+- **Bug fixes and performance improvements**: We've made general stability improvements to address key recovery issues, especially during upgrade scenarios. These updates are designed to ensure more reliable recovery processes and prevent unexpected service interruptions, delivering a smoother and more consistent experience.  
+- **Ephemeral Disk Performance Enhancements**: We improved overall performance for Azure Container Storage with ephemeral NVMe disks as the backing storage option, delivering up to a 100% increase in write IOPS in setups with replication enabled. For more details, read about ephemeral disk performance [using local NVMe](/azure/storage/container-storage/use-container-storage-with-local-disk#optimize-performance-when-using-local-nvme) and [using local NVMe with replication](/azure/storage/container-storage/use-container-storage-with-local-nvme-replication#optimize-performance-when-using-local-nvme).
 
 ## Version 1.1.2 
 
-### Improvements and issues that are fixed 
+### Improvements and issues that are fixed
+
 - **Bug fixes and performance improvements**: We improved the overall system stability by fixing general bugs and optimizing performance.
 - **Security Enhancements**: This release improves security by updating package dependencies and Microsoft container images and improving container image builds to reduce dependencies.
 - **Volume attachment fixes**: We also resolved an issue where volumes remained in a published state on nodes that were no longer present in the cluster, causing volume mounts to fail. This fix ensures that volumes are properly detached and reattached, allowing workloads to continue without interruptions. 
 
-
 ## Version 1.1.1
 
 ### Improvements and issues that are fixed
@@ -60,12 +60,14 @@ A **major release** introduces significant changes, often including new features
 - **Data plane stability**: We've also improved the stability of data-plane components, ensuring more reliable access to Azure Container Storage volumes and storage pools. This also enhances the management of data replication between storage nodes.
 - **Volume management improvements**: The update resolves issues with volume detachment during node drain scenarios, ensuring that volumes are safely and correctly detached, and allowing workloads to migrate smoothly without interruptions or data access issues.
 
-## Azure Container Storage Support Policy
+## Azure Container Storage support policy
+
 Azure Container Storage follows a transparent and predictable support lifecycle which is aligned with the overall AKS extension guidance on product lifecycle and support plan. In this way, we ensure you can plan your deployments and upgrades effectively. This section outlines the lifecycle, support commitment, and Kubernetes version compatibility for each Azure Container Storage release. 
 
-### Lifecycle and Patch Support 
-- **Major/Minor Releases**: Supported for 12 months from the release date. 
-- **Patch Releases**: Have the same end of life as the subsequent major/minor release.  
+### Lifecycle and patch support
+
+- **Major/minor releases**: Supported for 12 months from the release date. 
+- **Patch releases**: Have the same end of life as the subsequent major/minor release.  
 
 | Release version | Release Date  | End of Life | Supported Kubernetes Versions |
 |----|----------------| ------------| -------- |
@@ -74,19 +76,22 @@ Azure Container Storage follows a transparent and predictable support lifecycle
 |1.1.1- Patch Release | 09/20/2024 | 07/29/2025 | 1.29, 1.28, 1.27 | 
 |1.1.0- General Availability| 07/30/2024 | 07/29/2025 | 1.29, 1.28, 1.27 | 
 
-### Kubernetes Version Compatibility 
-Azure Container Storage aligns with AKS support for Kubernetes versions using the N-2 practice. For each release: 
+### Kubernetes version compatibility
+
+Azure Container Storage aligns with AKS support for Kubernetes versions using the N-2 practice. When releasing a major or minor version, Azure Container Storage validates the latest three available Kubernetes versions in AKS and updates the supported Kubernetes versions accordingly. For each release:
+
 - It supports the latest Kubernetes version generally available with AKS and the two prior versions. 
-- If compatibility is not possible due to deprecation or breaking API changes, the release notes will explicitly call out these exceptions.
+- If compatibility isn't possible due to deprecation or breaking API changes, the release notes will explicitly call out these exceptions.
 
-### Important Guidance for Version Synchronization 
+Before upgrading the Kubernetes version in your AKS cluster, we recommend checking if the version is included in the Azure Container Storage version support list. If the latest Azure Container Storage version doesn't yet support it, consider deferring the upgrade. As a general best practice, validate your workloads with the new version of Kubernetes or the new version of dependent components in a staging environment before upgrading in the production environment. 
 
-To maintain compatibility and avoid unvalidated combinations of Azure Container Storage and AKS: 
+### Important guidance for version synchronization 
 
-- All patch releases within a minor version (e.g., 1.1.x) will support the same Kubernetes versions as the initial minor release (e.g., 1.1.0). 
+To maintain compatibility and avoid unvalidated combinations of Azure Container Storage and AKS: 
 
-- New minor releases (e.g., 1.2.0 and subsequent 1.2.x) will support a sliding window of Kubernetes versions, advancing to the next version with each new minor release (e.g., 1.2.0 supports 1.28, 1.29, 1.30). 
+- All patch releases within a minor version (for example, 1.1.x) will support the same Kubernetes versions as the initial minor release (for example, 1.1.0). 
 
+- New minor releases (for example, 1.2.0 and subsequent 1.2.x) will support a sliding window of Kubernetes versions, advancing to the next version with each new minor release (for example, 1.2.0 supports 1.28, 1.29, and 1.30). 
 
 ## Upgrade a preview installation to GA
 
@@ -115,7 +120,3 @@ If you would like to disable auto-upgrades, run the following command:
 ```azurecli-interactive
 az k8s-extension update --cluster-name <cluster name> --resource-group <resource-group> --cluster-type managedClusters --auto-upgrade-minor-version false -n azurecontainerstorage
 ```
-## FAQ
-- How should I ensure Azure Container Storage is compatible with the latest Kubernetes version? 
-
-When releasing a major or minor version, Azure Container Storage validates the latest three available Kubernetes versions in AKS and updates the supported Kubernetes versions accordingly. Before upgrading the Kubernetes version in your AKS cluster, it is recommended to check if the version is included in the Azure Container Storage version support list. If the latest Azure Container Storage version does not yet support it, consider deferring the upgrade. As a general best practice, validate your workloads with the new version of Kubernetes or the new version of dependent components in a staging environment before upgrading in the production environment.