fix some links

coder · matifali · May 22, 2024 · May 23, 2024 · May 23, 2024 · May 23, 2024
commit d00cc9b6995bbb34b8d607631027e91d5987f448
diff --git a/docs/admin/integrations/jfrog-artifactory.md b/docs/admin/integrations/jfrog-artifactory.md
@@ -37,7 +37,7 @@ two type of modules that automate the JFrog Artifactory and Coder integration.
 
 This module is usable by JFrog self-hosted (on-premises) Artifactory as it
 requires configuring a custom integration. This integration benefits from
-Coder's [external-auth](https://coder.com/docs/v2/latest/admin/external-auth)
+Coder's [external-auth](https://coder.com/docs/admin/external-auth)
 feature and allows each user to authenticate with Artifactory using an OAuth
 flow and issues user-scoped tokens to each user.
 
@@ -72,7 +72,7 @@ artifactory:
 ![JFrog Platform new integration](../images/guides/artifactory-integration/jfrog-oauth-app.png)
 
 3. Add a new
-   [external authentication](https://coder.com/docs/v2/latest/admin/external-auth)
+   [external authentication](https://coder.com/docs/admin/external-auth)
    to Coder by setting these env variables,
 
 ```env

diff --git a/docs/admin/templates/extending-templates/icons.md b/docs/admin/templates/extending-templates/icons.md
@@ -32,7 +32,7 @@ come bundled with your Coder deployment.
   }
   ```
 
-- [**Authentication Providers**](https://coder.com/docs/v2/latest/admin/external-auth):
+- [**Authentication Providers**](https://coder.com/docs/admin/external-auth):
 
   - Use icons for external authentication providers to make them recognizable.
     You can set an icon for each provider by setting the

diff --git a/docs/admin/users/oidc-auth.md b/docs/admin/users/oidc-auth.md
@@ -224,7 +224,7 @@ OIDC provider will be added to the `myCoderGroupName` group in Coder.
 ### Group allowlist
 
 You can limit which groups from your identity provider can log in to Coder with
-[CODER_OIDC_ALLOWED_GROUPS](https://coder.com/docs/v2/latest/cli/server#--oidc-allowed-groups).
+[CODER_OIDC_ALLOWED_GROUPS](https://coder.com/docs/reference/cli/server#--oidc-allowed-groups).
 Users who are not in a matching group will see the following error:
 
 ![Unauthorized group error](../images/admin/group-allowlist.png)

diff --git a/docs/admin/users/password-auth.md b/docs/admin/users/password-auth.md
@@ -12,7 +12,7 @@ server.
 ## Restore the `Owner` user
 
 If you remove the admin user account (or forget the password), you can run the
-[`coder server create-admin-user`](https://coder.com/docs/v2/latest/cli/server_create-admin-user)
+[`coder server create-admin-user`](https://coder.com/docs/reference/cli/server_create-admin-user)
 command on your server.
 
 > Note: You must run this command on the same machine running the Coder server.
@@ -24,4 +24,4 @@ command on your server.
 
 An admin must reset passwords on behalf of users. This can be done in the web UI
 in the Users page or CLI:
-[`coder reset-password`](https://coder.com/docs/v2/latest/cli/reset-password)
+[`coder reset-password`](https://coder.com/docs/cli/reset-password)
diff --git a/docs/admin/users/sessions-tokens.md b/docs/admin/users/sessions-tokens.md
@@ -54,11 +54,11 @@ for more info.
 Today, you must use the REST API to generate a token on behalf of another user.
 You must have the `Owner` role to do this. Use our API reference for more
 information:
-[Create token API key](https://coder.com/docs/v2/latest/api/users#create-token-api-key)
+[Create token API key](https://coder.com/docs/reference/api/users#create-token-api-key)
 
 ### Set max token length
 
 You can use the
-[`CODER_MAX_TOKEN_LIFETIME`](https://coder.com/docs/v2/latest/cli/server#--max-token-lifetime)
+[`CODER_MAX_TOKEN_LIFETIME`](https://coder.com/docs/reference/cli/server#--max-token-lifetime)
 server flag to set the maximum duration for long-lived tokens in your
 deployment.
diff --git a/docs/install/other/README.md b/docs/install/other/README.md
@@ -4,8 +4,8 @@ Coder has a number of alternate unofficial install methods. Contributions are we
 
 | Platform Name                                                                     | Status     | Documentation                                                                                |
 | --------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- |
-| AWS EC2                                                                           | Official   | [Guide: AWS](https://coder.com/docs/v2/latest/platforms/aws)                                 |
-| Google Compute Engine                                                             | Official   | [Guide: Google Compute Engine](https://coder.com/docs/v2/latest/platforms/gcp)               |
+| AWS EC2                                                                           | Official   | [Guide: AWS](https://coder.com/docs/platforms/aws)                                 |
+| Google Compute Engine                                                             | Official   | [Guide: Google Compute Engine](https://coder.com/docs/platforms/gcp)               |
 | 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)  |

diff --git a/docs/tutorials/README.md b/docs/tutorials/README.md
@@ -6,5 +6,5 @@ Enterprise. These are hosted on our
 request new topics to be covered.
 
 <children>
-  This page is rendered on https://coder.com/docs/v2/latest/guides. Refer to the other documents in the `guides/` directory for specific employee-written guides.
+  This page is rendered on https://coder.com/docs/guides. Refer to the other documents in the `guides/` directory for specific employee-written guides.
 </children>
diff --git a/docs/tutorials/artifactory-integration.md b/docs/tutorials/artifactory-integration.md
@@ -37,7 +37,7 @@ two type of modules that automate the JFrog Artifactory and Coder integration.
 
 This module is usable by JFrog self-hosted (on-premises) Artifactory as it
 requires configuring a custom integration. This integration benefits from
-Coder's [external-auth](https://coder.com/docs/v2/latest/admin/external-auth)
+Coder's [external-auth](https://coder.com/docs/admin/external-auth)
 feature and allows each user to authenticate with Artifactory using an OAuth
 flow and issues user-scoped tokens to each user.
 
@@ -72,7 +72,7 @@ artifactory:
 ![JFrog Platform new integration](../images/guides/artifactory-integration/jfrog-oauth-app.png)
 
 3. Add a new
-   [external authentication](https://coder.com/docs/v2/latest/admin/external-auth)
+   [external authentication](https://coder.com/docs/admin/external-auth)
    to Coder by setting these env variables,
 
 ```env

diff --git a/docs/tutorials/configuring-okta.md b/docs/tutorials/configuring-okta.md
@@ -16,7 +16,7 @@ December 13, 2023
 
 To configure custom claims in Okta to support syncing roles and groups with
 Coder, you must first have setup an Okta application with
-[OIDC working with Coder](https://coder.com/docs/v2/latest/admin/auth#openid-connect).
+[OIDC working with Coder](https://coder.com/docs/admin/auth#openid-connect).
 From here, we will add additional claims for Coder to use for syncing groups and
 roles.
 
@@ -39,14 +39,14 @@ be sent.
 
 > !! If the user does not belong to any groups, the claim will not be sent. Make
 > sure the user authenticating for testing is in at least 1 group. Defer to
-> [troubleshooting](https://coder.com/docs/v2/latest/admin/auth#troubleshooting)
+> [troubleshooting](https://coder.com/docs/admin/auth#troubleshooting)
 > with issues
 
 ![Okta OpenID Connect ID Token](../images/guides/okta/oidc_id_token.png)
 
 Configure Coder to use these claims for group sync. These claims are present in
 the `id_token`. See all configuration options for group sync in the
-[docs](https://coder.com/docs/v2/latest/admin/auth#group-sync-enterprise).
+[docs](https://coder.com/docs/admin/auth#group-sync-enterprise).
 
 ```bash
 # Add the 'groups' scope.

diff --git a/docs/tutorials/example-guide.md b/docs/tutorials/example-guide.md
@@ -11,14 +11,14 @@ December 13, 2023
 ---
 
 This is a guide on how to make Coder guides, it is not listed on our
-[official guides page](https://coder.com/docs/v2/latest/guides) in the docs.
+[official guides page](https://coder.com/docs/guides) in the docs.
 Intended for those who don't frequently contribute documentation changes to the
 `coder/coder` repository.
 
 ## Content
 
 Defer to our
-[Contributing/Documentation](https://coder.com/docs/v2/latest/contributing/documentation)
+[Contributing/Documentation](https://coder.com/docs/contributing/documentation)
 page for rules on technical writing.
 
 ### Adding Photos

diff --git a/docs/tutorials/faqs.md b/docs/tutorials/faqs.md
@@ -41,7 +41,7 @@ The primary developer use case is a local IDE connecting over SSH to a Coder
 workspace.
 
 Coder's networking stack has intelligence to attempt a peer-to-peer or
-[Direct connection](https://coder.com/docs/v2/latest/networking#direct-connections)
+[Direct connection](https://coder.com/docs/networking#direct-connections)
 between the local IDE and the workspace. However, this requires some additional
 protocols like UDP and being able to reach a STUN server to echo the IP
 addresses of the local IDE machine and workspace, for sharing using a Wireguard
@@ -58,9 +58,9 @@ troubleshooting.
 
 | Flag                                                                                                           | Value       | Meaning                               |
 | -------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------- |
-| [`CODER_BLOCK_DIRECT`](https://coder.com/docs/v2/latest/cli/server#--block-direct-connections)                 | `true`      | Blocks direct connections             |
-| [`CODER_DERP_SERVER_STUN_ADDRESSES`](https://coder.com/docs/v2/latest/cli/server#--derp-server-stun-addresses) | `"disable"` | Disables STUN                         |
-| [`CODER_DERP_FORCE_WEBSOCKETS`](https://coder.com/docs/v2/latest/cli/server#--derp-force-websockets)           | `true`      | Forces websockets over Tailscale DERP |
+| [`CODER_BLOCK_DIRECT`](https://coder.com/docs/reference/cli/server#--block-direct-connections)                 | `true`      | Blocks direct connections             |
+| [`CODER_DERP_SERVER_STUN_ADDRESSES`](https://coder.com/docs/reference/cli/server#--derp-server-stun-addresses) | `"disable"` | Disables STUN                         |
+| [`CODER_DERP_FORCE_WEBSOCKETS`](https://coder.com/docs/reference/cli/server#--derp-force-websockets)           | `true`      | Forces websockets over Tailscale DERP |
 
 ### How do I configure NGINX as the reverse proxy in front of Coder?
 
@@ -125,7 +125,7 @@ An important concept to understand is that Coder creates workspaces which have
 an agent that must be able to reach the `coder server`.
 
 If the
-[`CODER_ACCESS_URL`](https://coder.com/docs/v2/latest/admin/configure#access-url)
+[`CODER_ACCESS_URL`](https://coder.com/docs/admin/configure#access-url)
 is not accessible from a workspace, the workspace may build, but the agent
 cannot reach Coder, and thus the missing icons. e.g., Terminal, IDEs, Apps.
 
@@ -155,7 +155,7 @@ of these values can lead to existing workspaces failing to start. This issue
 occurs because the Terraform state will not be in sync with the new template.
 
 However, a lesser-known CLI sub-command,
-[`coder update`](https://coder.com/docs/v2/latest/cli/update), can resolve this
+[`coder update`](https://coder.com/docs/reference/cli/update), can resolve this
 issue. This command re-prompts users to re-enter the input variables,
 potentially saving the workspace from a failed status.
 
@@ -296,12 +296,12 @@ References:
 
 - [Public Github Issue 6117](https://github.com/coder/coder/issues/6117)
 - [Public Github Issue 5677](https://github.com/coder/coder/issues/5677)
-- [Coder docs: Templates/Change Management](https://coder.com/docs/v2/latest/templates/change-management)
+- [Coder docs: Templates/Change Management](https://coder.com/docs/templates/change-management)
 
 ### Can I run Coder in an air-gapped or offline mode? (no Internet)?
 
 Yes, Coder can be deployed in air-gapped or offline mode.
-https://coder.com/docs/v2/latest/install/offline
+https://coder.com/docs/install/offline
 
 Our product bundles with the Terraform binary so assume access to terraform.io
 during installation. The docs outline rebuilding the Coder container with

diff --git a/docs/tutorials/xray-integration.md b/docs/tutorials/xray-integration.md
@@ -27,9 +27,9 @@ using Coder's [JFrog Xray Integration](https://github.com/coder/coder-xray).
    [permission](https://jfrog.com/help/r/jfrog-platform-administration-documentation/permissions)
    for the repositories you want to scan.
 2. Create a Coder
-   [token](https://coder.com/docs/v2/latest/cli/tokens_create#tokens-create)
+   [token](https://coder.com/docs/reference/cli/tokens_create#tokens-create)
    with a user that has the
-   [`owner`](https://coder.com/docs/v2/latest/admin/users#roles) role.
+   [`owner`](https://coder.com/docs/admin/users#roles) role.
 3. Create kubernetes secrets for the JFrog Xray and Coder tokens.
 
 ```bash

diff --git a/docs/user-guides/workspace-access/web-ides.md b/docs/user-guides/workspace-access/web-ides.md
@@ -82,10 +82,10 @@ resource "coder_app" "rstudio" {
 ```
 
 If you cannot enable a
-[wildcard subdomain](https://coder.com/docs/v2/latest/admin/configure#wildcard-access-url),
+[wildcard subdomain](https://coder.com/docs/admin/configure#wildcard-access-url),
 you can configure the template to run RStudio on a path using an NGINX reverse
 proxy in the template. There is however
-[security risk](https://coder.com/docs/v2/latest/cli/server#--dangerous-allow-path-app-sharing)
+[security risk](https://coder.com/docs/reference/cli/server#--dangerous-allow-path-app-sharing)
 running an app on a path and the template code is more complicated with coder
 value substitution to recreate the path structure.