Apply suggestions from code review

kacpersaw · matifali · web-flow · commit ddfd65111a74 · 2025-08-22T08:23:23.000+02:00
Co-authored-by: Atif Ali &lt;atif@coder.com&gt;
diff --git a/docs/admin/templates/index.md b/docs/admin/templates/index.md
@@ -61,6 +61,6 @@ needs of different teams.
   changes are reviewed and tested.
 - [Permissions and Policies](./template-permissions.md): Control who may access
   and modify your template.
-- [Early Access External Workspaces](./managing-templates/external-workspaces.md): Learn how to connect your existing infrastructure to Coder workspaces.
+- [External Workspaces](./managing-templates/external-workspaces.md): Learn how to connect your existing infrastructure to Coder workspaces.
 
 <children></children>
diff --git a/docs/admin/templates/managing-templates/external-workspaces.md b/docs/admin/templates/managing-templates/external-workspaces.md
@@ -1,27 +1,31 @@
-# External workspaces
+# External Workspaces
 
-External workspaces allow you to connect agents running on external infrastructure to your Coder deployment. This feature enables you to bring existing servers, on-premises infrastructure, or any machine that can run the Coder agent into your development environment without requiring Coder to provision the compute resources.
+External workspaces allow you to seamlessly connect externally managed infrastructure as Coder workspaces. This enables you to integrate existing servers, on-premises systems, or any capable machine with the Coder environment, ensuring a smooth and efficient development workflow without requiring Coder to provision additional compute resources.
 
 ## Prerequisites
 
 - Access to external compute resources (VMs, bare-metal servers, Kubernetes nodes, etc.) that can run the Coder agent.
-- Networking configured so the external agent can reach your Coder deployment.
-- A workspace template that includes a coder_external_agent resource.
-- To import the template and begin configuring it, follow the [documentation in the Coder Registry](https://registry.coder.com/templates/coder-labs/externally-managed-workspace)
+- Networking access to your Coder deployment.
+- A workspace template that includes a [`coder_external_agent`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/external_agent) resource.
 
-## Benefits of external workspaces
 
-External workspaces provide flexibility and control in complex environments:
+We provide an example template on how to set up external workspaces in the [Coder Registry](https://registry.coder.com/templates/coder-labs/externally-managed-workspace)
+
+## Benefits
+
+External workspaces offer flexibility and control in complex environments:
 
 - **Incremental adoption of Coder**
 
-  Connect existing infrastructure without migrating everything at once.
+  Integrate with existing infrastructure gradually without needing to migrate everything at once.
+
 - **Flexibility**
 
-  Attach cloud, hybrid, or on-prem machines as developer workspaces.
+  Attach cloud, hybrid, or on-premises machines as developer workspaces.
+
 - **Separation of concerns**
 
-  Provision compute resources externally (your existing IaC or manual processes) while still using Terraform to manage workspace configuration (apps, scripts).
+  Provision compute resources externally (using your existing IaC or manual processes) while managing workspace configuration (apps, scripts) with Terraform.
 
 ## Use cases
 
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -523,7 +523,8 @@
 								{
 									"title": "Early Access External Workspaces",
 									"description": "Learn how to manage external workspaces",
-									"path": "./admin/templates/managing-templates/external-workspaces.md"
+									"path": "./admin/templates/managing-templates/external-workspaces.md",
+									"state": ["early access"]					
 								}
 							]
 						},

Original file line number	Diff line number	Diff line change
`@@ -523,7 +523,8 @@`
`523`	`523`	`{`
`524`	`524`	`"title": "Early Access External Workspaces",`
`525`	`525`	`"description": "Learn how to manage external workspaces",`
`526`		`- "path": "./admin/templates/managing-templates/external-workspaces.md"`
	`526`	`+ "path": "./admin/templates/managing-templates/external-workspaces.md",`
	`527`	`+ "state": ["early access"]`
`527`	`528`	`}`
`528`	`529`	`]`
`529`	`530`	`},`