coder · bpmct · Jan 23, 2024 · Jan 22, 2024 · Jan 22, 2024 · Jan 22, 2024
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -4,8 +4,8 @@
 
 We recommend using the [Nix](https://nix.dev/) package manager as it makes any
 pain related to maintaining dependency versions
-[just disappear](https://twitter.com/mitchellh/status/1491102567296040961). Once
-nix [has been installed](https://nixos.org/download.html) the development
+[disappear](https://nixos.org/guides/how-nix-works). Once nix
+[has been installed](https://nixos.org/download.html) the development
 environment can be _manually instantiated_ through the `nix-shell` command:
 
 ```shell

diff --git a/docs/README.md b/docs/README.md
@@ -105,4 +105,4 @@ Azure, Google Cloud, Kubernetes, and more.
 ## Up next
 
 - Learn about [Templates](./templates/index.md)
-- [Install Coder](./install/install.sh.md)
+- [Install Coder](./install/index.md#install-coder)
diff --git a/docs/admin/appearance.md b/docs/admin/appearance.md
@@ -36,7 +36,7 @@ users of which network their Coder deployment is on.
 
 ## OIDC Login Button Customization
 
-[Use environment variables to customize](../auth#oidc-login-customization) the
+[Use environment variables to customize](./auth.md#oidc-login-customization) the
 text and icon on the OIDC button on the Sign In page.
 
 ## Support Links

diff --git a/docs/admin/configure.md b/docs/admin/configure.md
@@ -130,8 +130,8 @@ steps:
 
 ## System packages
 
-If you've installed Coder via a [system package](../install/packages.md) Coder,
-you can configure the server by setting the following variables in
+If you've installed Coder via a [system package](../install/index.md) Coder, you
+can configure the server by setting the following variables in
 `/etc/coder.d/coder.env`:
 
 ```env

diff --git a/docs/changelogs/v2.1.5.md b/docs/changelogs/v2.1.5.md
@@ -11,7 +11,7 @@
 
 - You can install Coder with
   [Homebrew](https://formulae.brew.sh/formula/coder#default) (#9414) (@aslilac).
-  Our [install script](https://coder.com/docs/v2/latest/install/install.sh) will
+  Our [install script](https://coder.com/docs/v2/latest/install#install-coder) will
   also use Homebrew, if present on your machine.
 - You can show/hide specific
   [display apps](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#nested-schema-for-display_apps)

diff --git a/docs/changelogs/v2.5.1.md b/docs/changelogs/v2.5.1.md
@@ -4,7 +4,7 @@
 
 - Add metrics for workspace agent scripts (#11132) (@Emyrk)
 - Add a user-configurable theme picker (#11140) (@aslilac)
-  ![Theme picker](https://github-production-user-asset-6210df.s3.amazonaws.com/22407953/290677070-14a5f3e3-b807-4091-851f-036821fca1a7.png)
+  ![Theme picker](https://i.imgur.com/rUAWz6B.png)
   > A [light theme](https://github.com/coder/coder/issues/8396) is coming soon
 - Various improvements to bulk delete flow (#11093) (@aslilac)
 

diff --git a/docs/changelogs/v2.7.0.md b/docs/changelogs/v2.7.0.md
@@ -36,7 +36,7 @@ are backwards-compatible and have been tested significantly with the goal of imp
 - Add support for loading template variables from tfvars files (#11549) (@mtojek)
 - Expose support links as [env variables](https://coder.com/docs/v2/latest/cli/server#--support-links) (#11697) (@mtojek)
 - Allow custom icons in the "support links" navbar (#11629) (@mtojek)
-  ![Custom icons](https://private-user-images.githubusercontent.com/14044910/296802415-80e0f0a0-409f-43c9-9bf0-c915bf89eef2.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MDU2ODAwOTAsIm5iZiI6MTcwNTY3OTc5MCwicGF0aCI6Ii8xNDA0NDkxMC8yOTY4MDI0MTUtODBlMGYwYTAtNDA5Zi00M2M5LTliZjAtYzkxNWJmODllZWYyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDAxMTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwMTE5VDE1NTYzMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTE0MTExYmEyMGMxMWFhNDlkMzczZjA1YmU2NzMyNjNlYWM1YzEwZDgyODEwOGM3MjMyZjY1YTM4NDg2NDYwZDMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.YVtG5fBnwM5FbJ8zzkTXfYVSp7Ao0wrAkRSu2f66meM)
+  ![Custom icons](https://i.imgur.com/FvJ8mFH.png)
 - Add additional fields to first time setup trial flow (#11533) (@coadler)
 - Manage provisioner tags in template editor (#11600) (@f0ssel)
 - Add `coder open vscode` CLI command (#11191) (@mafredri)

diff --git a/docs/faqs.md b/docs/faqs.md
@@ -17,8 +17,8 @@ In the UI, click the Deployment tab -> Licenses and upload the `jwt` license
 file.
 
 > To add the license with the CLI, first
-> [install the Coder CLI](https://coder.com/docs/v2/latest/install/install.sh)
-> and server to the latest release.
+> [install the Coder CLI](./install/index.md#install-script) and server to the
+> latest release.
 
 If the license is a text string:
 
@@ -450,9 +450,9 @@ Starting Colima on a M3 Macbook Pro:
 colima start --arch x86_64  --cpu 4 --memory 8 --disk 10
 ```
 
-Colima will show the path to the docker socket so I have a
-[Coder template](./docker-code-server/main.tf) that prompts the Coder admin to
-enter the docker socket as a Terraform variable.
+Colima will show the path to the docker socket so we have a
+[community template](https://github.com/sharkymark/v2-templates/tree/main/docker-code-server)
+that prompts the Coder admin to enter the docker socket as a Terraform variable.
 
 </details>
 

diff --git a/docs/guides/example-guide.md b/docs/guides/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](coder.com/docs/v2/latest/guides) in the docs. This is
-intended for those who don't frequently contribute documentation changes to the
+[official guides page](https://coder.com/docs/v2/latest/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](coder.com/docs/v2/latest/contributing/documentation)
+[Contributing/Documentation](https://coder.com/docs/v2/latest/contributing/documentation)
 page for rules on technical writing.
 
 ### Adding Photos

diff --git a/docs/install/1-click.md b/docs/install/1-click.md
@@ -1,12 +1,12 @@
 Coder can be installed on many cloud providers using our
 [one-click install packages](https://github.com/coder/packages)
 
-| Platform Name         | Status      | Documentation                                                                               | Deploy                                                                                                                                         |
-| --------------------- | ----------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| AWS EC2               | Live ✅     | [Guide: AWS](https://coder.com/docs/v2/latest/platforms/aws)                                | [Deploy from AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-5gxjyur2vc7rg?sr=0-2&ref_=beagle&applicationId=AWSMPContessa)     |
-| AWS EKS               | In progress | [Docs: Coder on Kubernetes](https://coder.com/docs/v2/latest/install/kubernetes)            | [Deploy from AWS Marketplace](https://example.com)                                                                                             |
-| Google Compute Engine | Live ✅     | [Guide: Google Compute Engine](https://coder.com/docs/v2/latest/platforms/gcp)              | [Deploy from GCP Marketplace](https://console.cloud.google.com/marketplace/product/coder-enterprise-market-public/coder-v2)                    |
-| Fly.io                | Live ✅     | [Blog: Run Coder on Fly.io](https://coder.com/blog/remote-developer-environments-on-fly-io) | [Deploy Coder on FLy.io](https://coder.com/blog/remote-developer-environments-on-fly-io)                                                       |
-| Railway.app           | Live ✅     | [Blog: Run Coder on Railway.app](https://coder.com/blog/deploy-coder-on-railway-app)        | [![Deploy Coder on Railway](https://railway.app/button.svg)](https://railway.app/template/coder?referralCode=tfH8Uw)                           |
-| Heroku                | Live ✅     | [Docs: Deploy Coder on Heroku](./heroku/README.md)                                          | [![Deploy Coder on Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/coder/packages) |
-| Render                | Live ✅     | [Docs: Deploy Coder on Render](./render/README.md)                                          | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/coder/packages) |
+| Platform Name         | Status      | Documentation                                                                                | Deploy                                                                                                                                         |
+| --------------------- | ----------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| AWS EC2               | Live ✅     | [Guide: AWS](https://coder.com/docs/v2/latest/platforms/aws)                                 | [Deploy from AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-5gxjyur2vc7rg?sr=0-2&ref_=beagle&applicationId=AWSMPContessa)     |
+| AWS EKS               | In progress | [Docs: Coder on Kubernetes](https://coder.com/docs/v2/latest/install/kubernetes)             | [Deploy from AWS Marketplace](https://example.com)                                                                                             |
+| Google Compute Engine | Live ✅     | [Guide: Google Compute Engine](https://coder.com/docs/v2/latest/platforms/gcp)               | [Deploy from GCP Marketplace](https://console.cloud.google.com/marketplace/product/coder-enterprise-market-public/coder-v2)                    |
+| Fly.io                | Live ✅     | [Blog: Run Coder on Fly.io](https://coder.com/blog/remote-developer-environments-on-fly-io)  | [Deploy Coder on Fly.io](https://coder.com/blog/remote-developer-environments-on-fly-io)                                                       |
+| Railway.app           | Live ✅     | [Blog: Run Coder on Railway.app](https://coder.com/blog/deploy-coder-on-railway-app)         | [![Deploy Coder on Railway](https://railway.app/button.svg)](https://railway.app/template/coder?referralCode=tfH8Uw)                           |
+| Heroku                | Live ✅     | [Docs: Deploy Coder on Heroku](https://github.com/coder/packages/blob/main/heroku/README.md) | [![Deploy Coder on Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/coder/packages) |
+| Render                | Live ✅     | [Docs: Deploy Coder on Render](https://github.com/coder/packages/blob/main/render/README.md) | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/coder/packages) |
diff --git a/docs/install/docker.md b/docs/install/docker.md
@@ -7,7 +7,7 @@ Docker is required. See the
 [official installation documentation](https://docs.docker.com/install/).
 
 > Note that the below steps are only supported on a Linux distribution. If on
-> macOS, please [run Coder via the standalone binary](./binary.md).
+> macOS, please [run Coder via the standalone binary](./index.md#manual).
 
 ## Run Coder with the built-in database (quick)
 

diff --git a/docs/install/index.md b/docs/install/index.md
@@ -38,7 +38,8 @@ curl -fsSL https://coder.com/install.sh | sh -s -- --help
 ## Homebrew
 
 To install Coder on Linux, you can use the [Homebrew](https://brew.sh/) package
-manager that uses our official [Homebrew tap](github.com/coder/homebrew-coder).
+manager that uses our official
+[Homebrew tap](https://github.com/coder/homebrew-coder).
 
 ```shell
 brew install coder/coder/coder
@@ -94,7 +95,8 @@ sudo apk add ./coder.apk
 
 ## Manual
 
-Get the latest `.tar.gz` package from our GitHub releases page and install it
+Get the latest `.tar.gz` package from our
+[GitHub releases](https://github.com/coder/coder/releases/latest) and install it
 manually.
 
 1. Download the

diff --git a/docs/platforms/aws.md b/docs/platforms/aws.md
@@ -3,8 +3,8 @@
 This guide is designed to get you up and running with a Coder proof-of-concept
 VM on AWS EC2 using a [Coder-provided AMI](https://github.com/coder/packages).
 If you are familiar with EC2 however, you can use our
-[install script](../install/install.sh.md) to run Coder on any popular Linux
-distribution.
+[install script](../install/index.md#install-coder) to run Coder on any popular
+Linux distribution.
 
 ## Requirements
 

diff --git a/docs/templates/icons.md b/docs/templates/icons.md
@@ -46,7 +46,7 @@ come bundled with your Coder deployment.
     CODER_EXTERNAL_AUTH_1_ICON=/icon/google.svg
     ```
 
-- [**Support Links**](../admin/appearance#support-links):
+- [**Support Links**](../admin/appearance.md#support-links):
 
   - Use icons for support links to make them recognizable. You can set the
     `icon` field for each link in `CODER_SUPPORT_LINKS` array.