Merge branch 'main' of https://github.com/Azure/azure-landing-zones

Azure · Jan 8, 2025 · 05f6763 · 05f6763
2 parents a0331da + 0665496
commit 05f6763
Show file tree

Hide file tree

Showing 16 changed files with 608 additions and 139 deletions.
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+  "cSpell.words": []
+}
diff --git a/docs/content/terraform/1_managementcomponents.md b/docs/content/terraform/1_managementcomponents.md
diff --git a/docs/content/terraform/2_networking/_index.md b/docs/content/terraform/2_networking/_index.md
diff --git a/docs/content/terraform/2_networking/a_hubnetworking.md b/docs/content/terraform/2_networking/a_hubnetworking.md
diff --git a/docs/content/terraform/2_networking/b_virtualwan.md b/docs/content/terraform/2_networking/b_virtualwan.md
diff --git a/docs/content/terraform/2_networking/c_privatedns.md b/docs/content/terraform/2_networking/c_privatedns.md
diff --git a/docs/content/terraform/2_networking/d_ddosprotection.md b/docs/content/terraform/2_networking/d_ddosprotection.md
diff --git a/docs/content/terraform/3_managementgroup/_index.md b/docs/content/terraform/3_managementgroup/_index.md
diff --git a/docs/content/terraform/_index.md b/docs/content/terraform/_index.md
@@ -7,7 +7,7 @@ weight: 20
 ALZ ❤️ AVM - A new approach to Azure Landing Zones with Terraform
 
 Based on continuous feedback from the community, we have adopted a more modular approach to deploying Azure Landing Zones with Terraform.
-This new approach is based on the Azure Virtual Network Module (AVM) and is designed to be more flexible.
+This new approach is based on [Azure Verified Modules](https://aka.ms/avm) (AVM) and is designed to be more flexible.
 
 ## Why have we made this change?
 
@@ -31,7 +31,7 @@ You also asked that we make it easier for organizations to have different teams
 
 ## What is the new approach?
 
-The new approach is based on  Azure Virtual Network Modules (AVM) and is designed to be more flexible.
+The new approach is based on [Azure Verified Modules](https://aka.ms/avm) and is designed to be more flexible.
 
 Here is the list of modules that pertain to Azure Landing Zones and covers the scope of the original ALZ Terraform module:
 
@@ -42,9 +42,15 @@ Here is the list of modules that pertain to Azure Landing Zones and covers the s
 - [Virtual WAN](https://registry.terraform.io/modules/Azure/avm-ptn-virtualwan/azurerm/latest)
 - [Private link DNS zones](https://registry.terraform.io/modules/Azure/avm-ptn-network-private-link-private-dns-zones/azurerm/latest)
 
+{{< hint type=tip >}}
+Refer to each module's documentation to understand the full list of features and customization options.
+In this documentation site, we will cover the ALZ core module and the inputs that we need.
+We do not cover the inputs to the other modules, as they are covered in the module documentation.
+{{< /hint >}}
+
 Using these modules together, you can create a fully customized Azure Landing Zone.
 
-## What if I want to use the old approach?
+## What if I want a simplified, all-in-one approach?
 
 If you want a simpler, more opinionated approach, you can use the [Accelerator]({{< relref "accelerator" >}}).
 This uses all the modules above, but in a pre-defined configuration and opinionated approach.
@@ -55,6 +61,8 @@ There are still customization options available, but the [Accelerator]({{< relre
 We recognize that this is a significant change, and we want to make it as easy as possible for you to get started.
 We have created this documentation site to centralize the integration documentation for the new modular approach.
 
-In here you will find examples and guidance on how to use the new modules to build your very own Azure Landing Zone.
+In here you will find guidance on how to use the ALZ Core module with those listed above to build your very own Azure Landing Zone.
+To proceed, you should be comfortable creating Terraform configurations and using Terraform modules.
+If you are not, we recommend that you take a look at the [Accelerator]({{< relref "accelerator" >}}) as it offers a simplified experience.
 
-TBC more soon...
+Move on to the [getting started]({{< relref "gettingStarted" >}}) section to get started with the new approach.