Merge branch 'restructure-new' of https://github.com/coder/coder into restructure-new

stirby · stirby · commit e066db5a4f97 · 2024-10-04T23:44:49.000Z
diff --git a/docs/admin/infrastructure/validated-architectures/index.md b/docs/admin/infrastructure/validated-architectures/index.md
@@ -68,12 +68,12 @@ web interface, the CLI tool, or directly calling API methods.
 
 ### Workspace
 
-A [workspace](../../../user-guides/workspace-creation.md) refers to an isolated
-development environment where users can write, build, and run code. Workspaces
-are fully configurable and can be tailored to specific project requirements,
-providing developers with a consistent and efficient development environment.
-Workspaces can be autostarted and autostopped, enabling efficient resource
-management.
+A [workspace](../../../user-guides/workspace-management.md) refers to an
+isolated development environment where users can write, build, and run code.
+Workspaces are fully configurable and can be tailored to specific project
+requirements, providing developers with a consistent and efficient development
+environment. Workspaces can be autostarted and autostopped, enabling efficient
+resource management.
 
 Users can connect to workspaces using SSH or via workspace applications like
 `code-server`, facilitating collaboration and remote access. Additionally,
diff --git a/docs/admin/monitoring/health-check.md b/docs/admin/monitoring/health-check.md
@@ -6,7 +6,8 @@ number of details about the health of your Coder deployment.
 ![Health check in Coder Dashboard](../../images/admin/monitoring/health-check.png)
 
 You can view it at `https://${CODER_URL}/health`, or you can alternatively view
-the [JSON response directly](../api/debug.md#debug-info-deployment-health).
+the
+[JSON response directly](../../reference/api/debug.md#debug-info-deployment-health).
 
 The deployment health page is broken up into the following sections:
 
diff --git a/docs/admin/monitoring/logs.md b/docs/admin/monitoring/logs.md
@@ -25,9 +25,9 @@ Connect logs are all captured in the `coderd` logs.
 ## `provisionerd` Logs
 
 Logs for [external provisioners](../provisioners.md) are structured
-[and configured](../../reference/cli/provisionerd_start.md#--log-human)
-similarly to `coderd` logs. Use these logs to troubleshoot and monitor the
-Terraform operations behind workspaces and templates.
+[and configured](../../reference/cli/provisioner_start.md#--log-human) similarly
+to `coderd` logs. Use these logs to troubleshoot and monitor the Terraform
+operations behind workspaces and templates.
 
 ## Workspace Logs
 
diff --git a/docs/admin/monitoring/notifications/index.md b/docs/admin/monitoring/notifications/index.md
@@ -73,7 +73,7 @@ flags.
 
 Notifications can currently be delivered by either SMTP or webhook. Each message
 can only be delivered to one method, and this method is configured globally with
-[`CODER_NOTIFICATIONS_METHOD`](../../../reference/cli/server#--notifications-method)
+[`CODER_NOTIFICATIONS_METHOD`](../../../reference/cli/server.md#--notifications-method)
 (default: `smtp`).
 
 Enterprise customers can configure which method to use for each of the supported
diff --git a/docs/admin/templates/creating-templates.md b/docs/admin/templates/creating-templates.md
@@ -152,8 +152,8 @@ templates for additional clouds (e.g. Hetzner, Alibaba) or orchestrators
 Refer to the following resources:
 
 - [Tutorial: Create a template from scratch](../../tutorials/template-from-scratch.md)
-- [Extending templates](./editing-templates.md): Features and concepts around
-  templates (agents, parameters, variables, etc)
+- [Extending templates](./extending-templates/index.md): Features and concepts
+  around templates (agents, parameters, variables, etc)
 - [Coder Registry](https://registry.coder.com/templates): Official and community
   templates for Coder
 - [Coder Terraform Provider Reference](https://registry.terraform.io/providers/coder/coder)
diff --git a/docs/admin/templates/managing-templates/index.md b/docs/admin/templates/managing-templates/index.md
@@ -12,7 +12,7 @@ them. Templates can also be [managed with git](./change-management.md), allowing
 any developer to propose changes to a template.
 
 You can give different users and groups access to templates with
-[role-based access control](../admin/rbac.md).
+[role-based access control](../template-permissions.md).
 
 ## Starter templates
 
diff --git a/docs/admin/users/oidc-auth.md b/docs/admin/users/oidc-auth.md
@@ -119,7 +119,7 @@ CODER_OIDC_ICON_URL=https://gitea.io/images/gitea.png
 ```
 
 To change the icon and text above the OpenID Connect button, see application
-name and logo url in [appearance](./appearance.md) settings.
+name and logo url in [appearance](../setup/appearance.md) settings.
 
 ## Disable Built-in Authentication
 
diff --git a/docs/admin/users/organizations.md b/docs/admin/users/organizations.md
@@ -74,7 +74,7 @@ Successfully created provisioner key data-cluster! Save this authentication toke
 Next, start the provisioner with the key on your desired platform. In this
 example, we'll start it using the Coder CLI on a host with Docker. For
 instructions on using other platforms like Kubernetes, see our
-[provisioner documentation](../admin/provisioners.md).
+[provisioner documentation](../provisioners.md).
 
 ```sh
 export CODER_URL=https://<your-coder-url>
diff --git a/docs/admin/users/quotas.md b/docs/admin/users/quotas.md
@@ -9,7 +9,7 @@ For example: A template is configured with a cost of 5 credits per day, and the
 user is granted 15 credits, which can be consumed by both started and stopped
 workspaces. This budget limits the user to 3 concurrent workspaces.
 
-Quotas are scoped to [Groups](./groups.md) in Enterprise and
+Quotas are scoped to [Groups](./groups-roles.md) in Enterprise and
 [organizations](./organizations.md) in Premium.
 
 ## Definitions
diff --git a/docs/admin/users/sessions-tokens.md b/docs/admin/users/sessions-tokens.md
@@ -44,8 +44,8 @@ Use the following command:
 coder tokens create --name=my-token --lifetime=720h
 ```
 
-See the help docs for [`coder tokens create`](../../reference/cli/tokens_create)
-for more info.
+See the help docs for
+[`coder tokens create`](../../reference/cli/tokens_create.md) for more info.
 
 </div>
 
diff --git a/docs/changelogs/v2.0.0.md b/docs/changelogs/v2.0.0.md
@@ -2,6 +2,8 @@ We are thrilled to release Coder v2.0.0. You can safely upgrade from any
 previous [coder/coder](https://github.com/coder/coder) release, but we feel like
 we have outgrown development (v0.x) releases:
 
+<!-- markdown-link-check-disable -->
+
 - 1600+ users develop on Coder every day
 - A single 4-core Coder server can
   [happily support](https://coder.com/docs/admin/scaling/scale-utility#recent-scale-tests) 1000+ users
@@ -64,6 +66,7 @@ ben@coder.com!
   Stream Kubernetes event logs to the Coder agent logs to reveal Kuernetes-level
   issues such as ResourceQuota limitations, invalid images, etc.
   ![Kubernetes quota](https://raw.githubusercontent.com/coder/coder/main/docs/platforms/kubernetes/coder-logstream-kube-logs-quota-exceeded.png)
+
 - [OIDC Role Sync](https://coder.com/docs/admin/users/oidc-auth.md#group-sync-enterprise-premium)
   (Enterprise): Sync roles from your OIDC provider to Coder roles (e.g.
   `Template Admin`) (#8595) (@Emyrk)
@@ -150,3 +153,5 @@ Compare:
 Refer to our docs to [install](https://coder.com/docs/install) or
 [upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
 release asset below.
+
+<!-- markdown-link-check-enable -->
diff --git a/docs/changelogs/v2.1.5.md b/docs/changelogs/v2.1.5.md
@@ -7,6 +7,8 @@
   [display app](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#nested-schema-for-display_apps).
   Keep reading for more details.
 
+<!-- markdown-link-check-disable -->
+
 ### Features
 
 - You can install Coder with
@@ -71,3 +73,5 @@
 Refer to our docs to [install](https://coder.com/docs/install) or
 [upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
 release asset below.
+
+<!-- markdown-link-check-enable -->
diff --git a/docs/faqs.md b/docs/faqs.md
diff --git a/docs/install/other/index.md b/docs/install/other/index.md
diff --git a/docs/start/first-workspace.md b/docs/start/first-workspace.md
diff --git a/docs/tutorials/faqs.md b/docs/tutorials/faqs.md
diff --git a/docs/user-guides/workspace-scheduling.md b/docs/user-guides/workspace-scheduling.md
