infrastructure landing page

bpmct · matifali · commit ee2c57601fa8 · 2024-08-12T17:01:25.000+03:00
diff --git a/docs/admin/infrastructure/README.md b/docs/admin/infrastructure/README.md
@@ -1,9 +1,21 @@
 # Infrastructure
 
-Guides for setting up and scaling Coder infrastructure.
+Learn how to spin up & manage Coder infrastructure.
 
 ## Architecture
 
-Coder is a self-hosted platform that runs on your own infrastructure. For large deployments, we recommend running the control plane on Kubernetes. Workspaces can be run as VMs or Kubernetes pods. The control plane (`coderd`) runs in a single region. However, workspace proxies, provisioners, and workspaces can run across regions or even cloud providers for the optimal developer experience.
+Coder is a self-hosted platform that runs on your own servers. For large deployments, we recommend running the control plane on Kubernetes. Workspaces can be run as VMs or Kubernetes pods. The control plane (`coderd`) runs in a single region. However, workspace proxies, provisioners, and workspaces can run across regions or even cloud providers for the optimal developer experience.
 
-Learn more about Coder's architecture and concepts: [Concepts](./architecture.md)
+Learn more about Coder's [architecture, concepts, and dependencies](./architecture.md).
+
+## Reference Architectures
+
+We publish [reference architectures](./reference/README.md) that include best practices around Coder configuration, infrastructure sizing, autoscaling, and operational readiness for different deployment sizes (e.g. `Up to 2000 users`).
+
+## Scale Tests
+
+Use our [scale test utility](./scale-tests.md) that can be run on your Coder deployment to simulate user activity and measure performance.
+
+## Monitoring
+
+See our dedicated [Monitoring](./monitoring.md) section for details around monitoring your Coder deployment via a bundled Grafana dashboard, health check, and/or within your own observibility stack via Prometheus metrics.
diff --git a/docs/admin/monitoring/README.md b/docs/admin/monitoring/README.md
@@ -0,0 +1 @@
+# Monitoring Coder
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -138,7 +138,7 @@
           "path": "./admin/infrastructure/README.md",
           "children": [
             {
-              "title": "Architecture Diagram",
+              "title": "Architecture",
               "description": "Learn about Coder's architecture",
               "path": "./admin/infrastructure/architecture.md"
             },
@@ -164,11 +164,6 @@
             {
               "title": "Scale Tests",
               "path": "./admin/infrastructure/scale-tests.md"
-            },
-            {
-              "title": "Health Check",
-              "description": "Learn about Coder's automated health checks",
-              "path": "./admin/infrastructure/health-check.md"
             }
           ]
         },
@@ -267,7 +262,14 @@
         {
           "title": "Monitoring",
           "description": "Configure security policy and audit your deployment",
-          "path": "./admin/security/README.md"
+          "path": "./admin/security/README.md",
+          "children": [
+            {
+              "title": "Health Check",
+              "description": "Learn about Coder's automated health checks",
+              "path": "./admin/monitoring/health-check.md"
+            }
+          ]
         },
         {
           "title": "Security",
