docs: add notice (#1223)

<!-- markdownlint-disable first-line-h1 -->

<!-- Thank you for submitting a Pull Request. Please fill out the
template below.-->
## Overview/Summary

Adds doc notice

** do not merge until w/c 20 January 2025 **

README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Azure landing zones Terraform module
 
+> [!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")

_README_header.md

@@ -1,5 +1,10 @@
 # Azure landing zones Terraform module
 
+> [!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")

docs/wiki/_Header.md

@@ -0,0 +1,5 @@
+<!-- markdownlint-disable MD041 -->
+> [!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.

modules/archetypes/README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Archetypes sub-module
 
+> [!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.
+
 ## Documentation
 <!-- markdownlint-disable MD033 -->
 

modules/archetypes/_README_header.md

@@ -1 +1,6 @@
 # Archetypes sub-module
+
+> [!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.

modules/connectivity/README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Connectivity sub-module
 
+> [!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.
+
 ## Documentation
 <!-- markdownlint-disable MD033 -->
 

modules/connectivity/_README_header.md

@@ -1 +1,6 @@
 # Connectivity sub-module
+
+> [!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.

modules/identity/README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Identity sub-module
 
+> [!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.
+
 ## Documentation
 <!-- markdownlint-disable MD033 -->
 

modules/identity/_README_header.md

@@ -1 +1,6 @@
 # Identity sub-module
+
+> [!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.

modules/management/README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Management sub-module
 
+> [!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.
+
 ## Documentation
 <!-- markdownlint-disable MD033 -->
 

modules/management/_README_header.md

@@ -1 +1,6 @@
 # Management sub-module
+
+> [!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.

modules/role_assignments_for_policy/README.md

@@ -1,6 +1,11 @@
 <!-- BEGIN_TF_DOCS -->
 # Role Assignment for Policy sub-module
 
+> [!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.
+
 ## Documentation
 <!-- markdownlint-disable MD033 -->
 

modules/role_assignments_for_policy/_README_header.md

@@ -1 +1,6 @@
 # Role Assignment for Policy sub-module
+
+> [!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.