Update internal documentation links

bpmct · bpmct · commit 4c072e073fd0 · 2024-10-04T23:40:03.000Z
Correct and update various internal links across documentation files
to ensure consistent navigation throughout the documentation set.
This enhances usability and reduces the potential for broken links.
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/install/other/index.md b/docs/install/other/index.md
@@ -3,15 +3,15 @@
 Coder has a number of alternate unofficial install methods. Contributions are
 welcome!
 
-| Platform Name                                                                     | Status     | Documentation                                                                               |
-| --------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------- |
-| AWS EC2                                                                           | Official   | [Guide: AWS](../cloud/ec2.md)                                                               |
-| Google Compute Engine                                                             | Official   | [Guide: Google Compute Engine](../cloud/compute-engine.md)                                  |
-| Azure AKS                                                                         | Unofficial | [GitHub: coder-aks](https://github.com/ericpaulsen/coder-aks)                               |
-| Terraform (GKE, AKS, LKE, DOKS, IBMCloud K8s, OVHCloud K8s, Scaleway K8s Kapsule) | Unofficial | [GitHub: coder-oss-terraform](https://github.com/ElliotG/coder-oss-tf)                      |
-| Fly.io                                                                            | Unofficial | [Blog: Run Coder on Fly.io](https://coder.com/blog/remote-developer-environments-on-fly-io) |
-| Garden.io                                                                         | Unofficial | [GitHub: garden-coder-example](https://github.com/garden-io/garden-coder-example)           |
-| Railway.app                                                                       | Unofficial | [Blog: Run Coder on Railway.app](https://coder.com/blog/deploy-coder-on-railway-app)        |
-| Heroku                                                                            | Unofficial | [Docs: Deploy Coder on Heroku](https://github.com/coder/packages/blob/main/heroku/index.md) |
-| Render                                                                            | Unofficial | [Docs: Deploy Coder on Render](https://github.com/coder/packages/blob/main/render/index.md) |
-| Snapcraft                                                                         | Unofficial | [Get it from the Snap Store](https://snapcraft.io/coder)                                    |
+| Platform Name                                                                     | Status     | Documentation                                                                                |
+| --------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- |
+| AWS EC2                                                                           | Official   | [Guide: AWS](../cloud/ec2.md)                                                                |
+| Google Compute Engine                                                             | Official   | [Guide: Google Compute Engine](../cloud/compute-engine.md)                                   |
+| Azure AKS                                                                         | Unofficial | [GitHub: coder-aks](https://github.com/ericpaulsen/coder-aks)                                |
+| Terraform (GKE, AKS, LKE, DOKS, IBMCloud K8s, OVHCloud K8s, Scaleway K8s Kapsule) | Unofficial | [GitHub: coder-oss-terraform](https://github.com/ElliotG/coder-oss-tf)                       |
+| Fly.io                                                                            | Unofficial | [Blog: Run Coder on Fly.io](https://coder.com/blog/remote-developer-environments-on-fly-io)  |
+| Garden.io                                                                         | Unofficial | [GitHub: garden-coder-example](https://github.com/garden-io/garden-coder-example)            |
+| Railway.app                                                                       | Unofficial | [Blog: Run Coder on Railway.app](https://coder.com/blog/deploy-coder-on-railway-app)         |
+| Heroku                                                                            | Unofficial | [Docs: Deploy Coder on Heroku](https://github.com/coder/packages/blob/main/heroku/README.md) |
+| Render                                                                            | Unofficial | [Docs: Deploy Coder on Render](https://github.com/coder/packages/blob/main/render/README.md) |
+| Snapcraft                                                                         | Unofficial | [Get it from the Snap Store](https://snapcraft.io/coder)                                     |
diff --git a/docs/start/first-workspace.md b/docs/start/first-workspace.md
@@ -5,9 +5,9 @@ each work from their own workspace and can use
 [multiple IDEs](../user-guides/workspace-access/index.md).
 
 A developer creates a workspace from a
-[shared template](../tutorials/templates/index.md). This lets an entire team
-work in environments that are identically configured and provisioned with the
-same resources.
+[shared template](../admin/templates/index.md). This lets an entire team work in
+environments that are identically configured and provisioned with the same
+resources.
 
 ## Before you begin
 
diff --git a/docs/user-guides/workspace-scheduling.md b/docs/user-guides/workspace-scheduling.md
@@ -9,7 +9,7 @@ configured by your template admin, which will stop a workspace when a user's
 absence is detected.
 
 To learn more workspace states and schedule, read the
-[workspace lifecycle](../admin/workspaces/lifecycle.md) documentation.
+[workspace lifecycle](../user-guides/workspace-lifecycle.md) documentation.
 
 ## Where to find the schedule settings
 
