feat: initial toc and hopme page (#2)

Azure · Oct 4, 2024 · 2455162 · 2455162
1 parent 532c940
commit 2455162
Show file tree

Hide file tree

Showing 14 changed files with 153 additions and 2 deletions.
diff --git a/docs/content/_index.md b/docs/content/_index.md
@@ -1,8 +1,50 @@
 ---
 title: Azure Landing Zones Documentation
 geekdocNav: true
-# geekdocAlign: center
+geekdocAlign: left
 geekdocAnchor: true
 ---
 
-TBC...
+Welcome to the Azure Landing Zones technical documentation site.
+This site provides guidance on how to deploy and manage Azure Landing Zones using the solutions we provide.
+
+Use the navigation links on the left to explore the documentation.
+
+## Definitions and Concepts
+
+Please see our [documentation on Learn](https://learn.microsoft.com/azure/cloud-adoption-framework/ready/landing-zone/) for an introduction to the concepts that we will build on here.
+
+## The Azure Landing Zones Journey
+
+The Azure Landing Zones journey is a multi-step process that starts with the enterprise bootstrap and ends with the deployment of workloads.
+
+```mermaid
+graph LR;
+    A[Enterprise bootstrap] --> B[Azure Landing Zones platform];
+    B --> C[Subscription vending];
+    C --> D[Applicaiton landing zones];
+    D --> E[Workloads];
+```
+
+### Enterprise bootstrap
+
+The enterprise bootstrap is the first step in the Azure Landing Zones journey.
+It is the process of setting up the foundational components that will be used to deploy and manage Azure Landing Zones.
+In this step we ensure we have the correct access and some subscriptions to work with.
+
+### Azure Landing Zones platform
+
+The Azure Landing Zones platform is the core of the Azure Landing Zones journey.
+It provides the core governance, networking, security and management components that will be used to deploy and manage Azure Landing Zones.
+
+### Subscription vending
+
+Subscription vending is the process of automating the creation of new subscriptions for use by the organization.
+
+### Application landing zones
+
+Application landing zones build upon subscription vending to provide applicaiton teams with a pre-configured environment to deploy their workloads.
+
+### Workloads
+
+Workloads are the applications and services that are deployed into the Azure Landing Zones.
diff --git a/docs/content/accalerator/_index.md b/docs/content/accalerator/_index.md
@@ -0,0 +1,6 @@
+---
+title: Accelerator
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
diff --git a/docs/content/bicep/1_enterprisebootstrap.md b/docs/content/bicep/1_enterprisebootstrap.md
@@ -0,0 +1,8 @@
+---
+title: 1. Enterprise Bootstrap
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/bicep/2_platform.md.md b/docs/content/bicep/2_platform.md.md
@@ -0,0 +1,8 @@
+---
+title: 2. Platform
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/bicep/3_networking.md b/docs/content/bicep/3_networking.md
@@ -0,0 +1,12 @@
+---
+title: 3. Networking
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
+
+## Hub & Spoke
+
+## Virtual WAN
diff --git a/docs/content/bicep/4_subscriptionvending.md b/docs/content/bicep/4_subscriptionvending.md
@@ -0,0 +1,8 @@
+---
+title: 4. Subscription Vending
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/bicep/5_applicationlandingzones.md b/docs/content/bicep/5_applicationlandingzones.md
@@ -0,0 +1,8 @@
+---
+title: 5. Application Landing Zones
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/bicep/_index.md b/docs/content/bicep/_index.md
@@ -0,0 +1,8 @@
+---
+title: Bicep
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/terraform/1_enterprisebootstrap.md b/docs/content/terraform/1_enterprisebootstrap.md
@@ -0,0 +1,8 @@
+---
+title: 1. Enterprise Bootstrap
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/terraform/2_platform.md.md b/docs/content/terraform/2_platform.md.md
@@ -0,0 +1,8 @@
+---
+title: 2. Platform
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/terraform/3_networking.md b/docs/content/terraform/3_networking.md
@@ -0,0 +1,11 @@
+---
+title: 3. Networking
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
+## Hub & Spoke
+
+## Virtual WAN
diff --git a/docs/content/terraform/4_subscriptionvending.md b/docs/content/terraform/4_subscriptionvending.md
@@ -0,0 +1,8 @@
+---
+title: 4. Subscription Vending
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/terraform/5_applicationlandingzones.md b/docs/content/terraform/5_applicationlandingzones.md
@@ -0,0 +1,8 @@
+---
+title: 5. Application Landing Zones
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...
diff --git a/docs/content/terraform/_index.md b/docs/content/terraform/_index.md
@@ -0,0 +1,8 @@
+---
+title: Terraform
+geekdocNav: true
+geekdocAlign: left
+geekdocAnchor: true
+---
+
+TBC...