docs: add deprecation notice for Terraform CAF Enterprise Scale module (#1298)

Adds deprecation notice to all modules

Author: matt-FFFFFF

README.md

@@ -4,13 +4,38 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
 
-[![Build Status](https://dev.azure.com/mscet/CAE-ALZ-Terraform/_apis/build/status/Tests/E2E?branchName=refs%2Ftags%2Fv6.0.0)](https://dev.azure.com/mscet/CAE-ALZ-Terraform/_build/latest?definitionId=26&branchName=refs%2Ftags%2Fv6.0.0)
-![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Azure/terraform-azurerm-caf-enterprise-scale?style=flat&logo=github)
-[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/azure/terraform-azurerm-caf-enterprise-scale.svg)](http://isitmaintained.com/project/azure/terraform-azurerm-caf-enterprise-scale "Average time to resolve an issue")
-[![Percentage of issues still open](http://isitmaintained.com/badge/open/azure/terraform-azurerm-caf-enterprise-scale.svg)](http://isitmaintained.com/project/azure/terraform-azurerm-caf-enterprise-scale "Percentage of issues still open")
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Azure/terraform-azurerm-caf-enterprise-scale/badge)](https://scorecard.dev/viewer/?uri=github.com/Azure/terraform-azurerm-caf-enterprise-scale)
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.
 
 Detailed information about how to use, configure and extend this module can be found on our Wiki:
 
@@ -20,17 +45,6 @@ Detailed information about how to use, configure and extend this module can be f
 - [Frequently Asked Questions](https://github.com/Azure/terraform-azurerm-caf-enterprise-scale/wiki/Frequently-Asked-Questions)
 - [Troubleshooting](https://github.com/Azure/terraform-azurerm-caf-enterprise-scale/wiki/Troubleshooting)
 
-## ‼ Notice of upcoming breaking changes
-
-We are planning to make some breaking changes to the module in the next release (Q4 2024).
-
-- Module defaults will updated to deploy zone redundant SKUs by default - this applies to:
-  - Firewall
-  - Public IP
-  - Virtual Network Gateway
-
-We will publish guidance on how to avoid re-deployment of existing resources nearer the time.
-
 ## Overview
 
 The [Azure landing zones Terraform module](https://registry.terraform.io/modules/Azure/caf-enterprise-scale/azurerm/latest) is designed to accelerate deployment of platform resources based on the [Azure landing zones conceptual architecture](https://learn.microsoft.com/azure/cloud-adoption-framework/ready/landing-zone#azure-landing-zone-conceptual-architecture) using Terraform.

_README_header.md

@@ -3,13 +3,38 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
 
-[![Build Status](https://dev.azure.com/mscet/CAE-ALZ-Terraform/_apis/build/status/Tests/E2E?branchName=refs%2Ftags%2Fv6.0.0)](https://dev.azure.com/mscet/CAE-ALZ-Terraform/_build/latest?definitionId=26&branchName=refs%2Ftags%2Fv6.0.0)
-![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Azure/terraform-azurerm-caf-enterprise-scale?style=flat&logo=github)
-[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/azure/terraform-azurerm-caf-enterprise-scale.svg)](http://isitmaintained.com/project/azure/terraform-azurerm-caf-enterprise-scale "Average time to resolve an issue")
-[![Percentage of issues still open](http://isitmaintained.com/badge/open/azure/terraform-azurerm-caf-enterprise-scale.svg)](http://isitmaintained.com/project/azure/terraform-azurerm-caf-enterprise-scale "Percentage of issues still open")
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Azure/terraform-azurerm-caf-enterprise-scale/badge)](https://scorecard.dev/viewer/?uri=github.com/Azure/terraform-azurerm-caf-enterprise-scale)
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.
 
 Detailed information about how to use, configure and extend this module can be found on our Wiki:
 
@@ -19,17 +44,6 @@ Detailed information about how to use, configure and extend this module can be f
 - [Frequently Asked Questions](https://github.com/Azure/terraform-azurerm-caf-enterprise-scale/wiki/Frequently-Asked-Questions)
 - [Troubleshooting](https://github.com/Azure/terraform-azurerm-caf-enterprise-scale/wiki/Troubleshooting)
 
-## ‼ Notice of upcoming breaking changes
-
-We are planning to make some breaking changes to the module in the next release (Q4 2024).
-
-- Module defaults will updated to deploy zone redundant SKUs by default - this applies to:
-  - Firewall
-  - Public IP
-  - Virtual Network Gateway
-
-We will publish guidance on how to avoid re-deployment of existing resources nearer the time.
-
 ## Overview
 
 The [Azure landing zones Terraform module](https://registry.terraform.io/modules/Azure/caf-enterprise-scale/azurerm/latest) is designed to accelerate deployment of platform resources based on the [Azure landing zones conceptual architecture](https://learn.microsoft.com/azure/cloud-adoption-framework/ready/landing-zone#azure-landing-zone-conceptual-architecture) using Terraform.

modules/archetypes/README.md

@@ -4,7 +4,38 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.
 
 ## Documentation
 <!-- markdownlint-disable MD033 -->

modules/archetypes/_README_header.md

@@ -3,4 +3,35 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.

modules/connectivity/README.md

@@ -4,7 +4,38 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.
 
 ## Documentation
 <!-- markdownlint-disable MD033 -->

modules/connectivity/_README_header.md

@@ -3,4 +3,35 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.

modules/identity/README.md

@@ -4,7 +4,38 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.
 
 ## Documentation
 <!-- markdownlint-disable MD033 -->

modules/identity/_README_header.md

@@ -3,4 +3,35 @@
 > [!IMPORTANT]
 > For new deployments we now recommend using Azure Verified Modules for Platform Landing Zones.
 > Please see the documentation at <https://aka.ms/alz/tf>.
-> This module will continue to be supported for existing deployments.
+
+## ⚠️ DEPRECATION NOTICE
+
+**This module is now in extended support mode and will be archived on August 1, 2026.**
+
+### Current Status
+
+- **Extended Support Period**: This module is now in extended support for one year (until August 1, 2026)
+- **Support Scope**: During this period, we will provide quality updates (e.g. bug fixes) and policy library updates only
+- **No New Features**: No new features or functionality will be added to this module
+
+### Migration Path
+
+We strongly recommend that all users migrate to the new **Azure Verified Modules** approach for Azure Landing Zones. This new approach provides:
+
+- Enhanced reliability and testing
+- Improved modularity and flexibility
+- Better alignment with Azure best practices
+- Ongoing feature development and support
+
+**Further reading**: Please read our recent [blog](https://techcommunity.microsoft.com/blog/azuretoolsblog/terraform-azure-verified-modules-for-platform-landing-zone-alz-migration-guidanc/4432035)
+
+**Migration Guide**: Please visit [aka.ms/alz/tf/migrate](https://aka.ms/alz/tf/migrate) for detailed migration guidance and resources.
+
+### Timeline
+
+- **Now - August 1, 2026**: Extended support (quality and policy updates only)
+- **August 1, 2026**: Repository will be archived and no further updates will be made
+
+### Questions?
+
+If you have questions about the migration process or need assistance, please refer to the migration documentation or raise an issue in the repository before the archive date.