consistency and words

EdwardAngert · EdwardAngert · commit 11891da1496d · 2025-07-09T05:24:38.000Z
diff --git a/docs/admin/templates/extending-templates/advanced-dev-containers.md b/docs/admin/templates/extending-templates/advanced-dev-containers.md
@@ -1,6 +1,6 @@
 # Advanced Dev Container Configuration
 
-This page extends [devcontainers.md](./devcontainers.md) with patterns for multiple dev containers,
+This page extends the [devcontainers documentation](./devcontainers.md) with patterns for multiple dev containers,
 user-controlled startup, repository selection, and infrastructure tuning.
 
 ## Run Multiple Dev Containers
@@ -11,7 +11,7 @@ In this example, there are two: `frontend` and `backend`:
 
 ```terraform
 # Clone each repo
-module "git_clone_frontend" {
+module "git-clone-frontend" {
   count    = data.coder_workspace.me.start_count
   source   = "dev.registry.coder.com/modules/git-clone/coder"
 
@@ -20,7 +20,7 @@ module "git_clone_frontend" {
   base_dir = "/home/coder/frontend"
 }
 
-module "git_clone_backend" {
+module "git-clone-backend" {
   count    = data.coder_workspace.me.start_count
   source   = "dev.registry.coder.com/modules/git-clone/coder"
 
@@ -33,15 +33,14 @@ module "git_clone_backend" {
 resource "coder_devcontainer" "frontend" {
   count            = data.coder_workspace.me.start_count
   agent_id         = coder_agent.main.id
-  workspace_folder = "/home/coder/frontend/${module.git_clone_frontend[0].folder_name}"
+  workspace_folder = "/home/coder/frontend/${module.git-clone-frontend[0].folder_name}"
 }
 
 resource "coder_devcontainer" "backend" {
   count            = data.coder_workspace.me.start_count
   agent_id         = coder_agent.main.id
-  workspace_folder = "/home/coder/backend/${module.git_clone_backend[0].folder_name}"
+  workspace_folder = "/home/coder/backend/${module.git-clone-backend[0].folder_name}"
 }
-
 ```
 
 Each dev container appears as a separate agent, so developers can connect to any
@@ -64,7 +63,7 @@ data "coder_parameter" "enable_frontend" {
 resource "coder_devcontainer" "frontend" {
   count            = data.coder_parameter.enable_frontend.value ? data.coder_workspace.me.start_count : 0
   agent_id         = coder_agent.main.id
-  workspace_folder = "/home/coder/frontend/${module.git_clone_frontend[0].folder_name}"
+  workspace_folder = "/home/coder/frontend/${module.git-clone-frontend[0].folder_name}"
 }
 ```
 
@@ -92,10 +91,10 @@ Prompt users to pick a repository or team at workspace creation time and clone t
    }
    ```
 
-1. Change the `git_clone` module to accept the `value` as the `url`:
+1. Change the `git-clone` module to accept the `value` as the `url`:
 
     ```terraform
-    module "git_clone" {
+    module "git-clone" {
      count    = data.coder_workspace.me.start_count
      source   = "dev.registry.coder.com/modules/git-clone/coder"
      agent_id = coder_agent.main.id
diff --git a/docs/admin/templates/extending-templates/devcontainers.md b/docs/admin/templates/extending-templates/devcontainers.md
@@ -9,11 +9,13 @@ modules and configurations outlined in this doc.
 
 ## Why Use Dev Containers
 
-Dev containers improve consistency across environments by letting developers define their development setup.
-When integrated with Coder templates, they provide:
+Dev containers improve consistency across environments by letting developers define their development setup within
+the code repository.
+
+When integrated with Coder templates, dev containers provide:
 
 - **Project-specific environments**: Each repository can define its own tools, extensions, and configuration.
-- **Zero setup time**: Developers get fully configured environments without manual installation.
+- **Zero setup time**: Developers start workspace with fully configured environments without additional installation.
 - **Consistency across teams**: Everyone works in identical environments regardless of their local machine.
 - **Version control**: Development environment changes are tracked alongside code changes.
 
@@ -55,7 +57,7 @@ RUN npm install -g @devcontainers/cli
 
 ## Define the Dev Container Resource
 
-If you don't use [`git_clone`](#clone-the-repository), point the resource at the folder that contains `devcontainer.json`:
+If you don't use [`git-clone`](#clone-the-repository), point the resource at the folder that contains `devcontainer.json`:
 
 ```terraform
 resource "coder_devcontainer" "project" { # `project` in this example is how users will connect to the dev container: `ssh://project.<workspace>.me.coder`
@@ -69,11 +71,11 @@ resource "coder_devcontainer" "project" { # `project` in this example is how use
 
 This step is optional, but it ensures that the project is present before the dev container starts.
 
-Note that if you use the `git_clone` module, update or replace the `coder_devcontainer` resource
-to point to `/home/coder/project/${module.git_clone[0].folder_name}` so that it is only defined once:
+Note that if you use the `git-clone` module, update or replace the `coder_devcontainer` resource
+to point to `/home/coder/project/${module.git-clone[0].folder_name}` so that it is only defined once:
 
 ```terraform
-module "git_clone" {
+module "git-clone" {
   count    = data.coder_workspace.me.start_count
   source   = "dev.registry.coder.com/modules/git-clone/coder"
   agent_id = coder_agent.main.id
@@ -84,7 +86,7 @@ module "git_clone" {
 resource "coder_devcontainer" "project" {
   count            = data.coder_workspace.me.start_count
   agent_id         = coder_agent.main.id
-  workspace_folder = "/home/coder/${module.git_clone[0].folder_name}"
+  workspace_folder = "/home/coder/${module.git-clone[0].folder_name}"
 }
 ```
 
@@ -143,7 +145,7 @@ resource "coder_devcontainer" "backend" {
 }
 ```
 
-## Example Docker Dev Container
+## Example Docker Dev Container Template
 
 <details><summary>Expand for the full file:</summary>
 
@@ -173,7 +175,7 @@ module "devcontainers-cli" {
   agent_id = coder_agent.main.id
 }
 
-module "git_clone" {
+module "git-clone" {
   count    = data.coder_workspace.me.start_count
   source   = "dev.registry.coder.com/modules/git-clone/coder"
   agent_id = coder_agent.main.id
@@ -184,7 +186,7 @@ module "git_clone" {
 resource "coder_devcontainer" "project" {
   count            = data.coder_workspace.me.start_count
   agent_id         = coder_agent.main.id
-  workspace_folder = "/home/coder/${module.git_clone[0].folder_name}"
+  workspace_folder = "/home/coder/${module.git-clone[0].folder_name}"
 }
 
 resource "docker_container" "workspace" {
