diff --git a/build/reference-architectures/templates/index.liquid b/build/reference-architectures/templates/index.liquid
index b4b62dba0d5..29940265ab5 100644
--- a/build/reference-architectures/templates/index.liquid
+++ b/build/reference-architectures/templates/index.liquid
@@ -1,13 +1,15 @@
 ---
-title: Azure Reference Architectures
-description: Reference architectures, blueprints, and prescriptive implementation guidance for common workloads on Azure.
+title: {{ title }}
+description: {{ description }}
 layout: LandingPage
-NOTE: edit the template in ./build/reference-architectures !!!
 ---
+<!-- This file is generated! -->
+<!-- See the templates in ./build/reference-architectures  -->
+<!-- See data in index.json -->
 
-# Azure Reference Architectures
+# {{ title }}
 
-Our reference architectures are arranged by scenario, with related architectures grouped together. Each architecture includes recommended practices, along with considerations for scalability, availability, manageability, and security. Most also include a deployable solution.
+{{ summary }}
 
 <section class="series">
     <ul class="panelContent">
diff --git a/docs/reference-architectures/index.json b/docs/reference-architectures/index.json
index 5f2a009926c..8a2fc4f11e3 100644
--- a/docs/reference-architectures/index.json
+++ b/docs/reference-architectures/index.json
@@ -1,4 +1,7 @@
 {
+    "title": "Azure Reference Architectures",
+    "description": "Reference architectures, blueprints, and prescriptive implementation guidance for common workloads on Azure.",
+    "summary": "Our reference architectures are arranged by scenario, with related architectures grouped together. Each architecture includes recommended practices, along with considerations for scalability, availability, manageability, and security. Most also include a deployable solution.",
     "series": [
         {
             "title": "Windows VM workloads",
diff --git a/docs/reference-architectures/index.md b/docs/reference-architectures/index.md
index 048a5e804ae..efe79cf7a0d 100644
--- a/docs/reference-architectures/index.md
+++ b/docs/reference-architectures/index.md
@@ -2,8 +2,10 @@
 title: Azure Reference Architectures
 description: Reference architectures, blueprints, and prescriptive implementation guidance for common workloads on Azure.
 layout: LandingPage
-NOTE: edit the template in ./build/reference-architectures !!!
 ---
+<!-- This file is generated! -->
+<!-- See the templates in ./build/reference-architectures  -->
+<!-- See data in index.json -->
 
 # Azure Reference Architectures