use new linter

EdwardAngert · EdwardAngert · commit b5b2e918aefa · 2025-01-03T18:36:08.000Z
diff --git a/docs/admin/integrations/island.md b/docs/admin/integrations/island.md
@@ -10,12 +10,12 @@ April 24, 2024
 
 ---
 
-[Island][] is an enterprise-grade browser, offering a Chromium-based experience
+[Island](https://www.island.io/) is an enterprise-grade browser, offering a Chromium-based experience
 similar to popular web browsers like Chrome and Edge. It includes built-in
 security features for corporate applications and data, aiming to bridge the gap
 between consumer-focused browsers and the security needs of the enterprise.
 
-Coder natively integrates with Island&rsquo;s feature set, which include data
+Coder natively integrates with Island's feature set, which include data
 loss protection (DLP), application awareness, browser session recording, and
 single sign-on (SSO). This guide intends to document these feature categories
 and how they apply to your Coder deployment.
@@ -28,18 +28,18 @@ We recommend creating an Application Group specific to Coder in the Island
 Management console. This Application Group object will be referenced when
 creating browser policies.
 
-[See the Island documentation for creating an Application Group][app-group].
+[See the Island documentation for creating an Application Group](https://documentation.island.io/docs/create-and-configure-an-application-group-object).
 
 ## Advanced Data Loss Protection
 
-Integrate Island&rsquo;s advanced data loss prevention (DLP) capabilities with
-Coder&rsquo;s cloud development environment (CDE), enabling you to control the
-&ldquo;last mile&rdquo; between developers&rsquo; CDE and their local devices,
+Integrate Island's advanced data loss prevention (DLP) capabilities with
+Coder's cloud development environment (CDE), enabling you to control the
+"last mile" between developers' CDE and their local devices,
 ensuring that sensitive IP remains in your centralized environment.
 
 ### Block cut, copy, paste, printing, screen share
 
-1. [Create a Data Sandbox Profile][data-sandbox].
+1. [Create a Data Sandbox Profile](https://documentation.island.io/docs/create-and-configure-a-data-sandbox-profile).
 
 1. Configure the following actions to allow/block (based on your security
    requirements).
@@ -49,27 +49,27 @@ ensuring that sensitive IP remains in your centralized environment.
    - Save Page
    - Clipboard Limitations
 
-1. [Create a Policy Rule][policy-rule] to apply the Data Sandbox Profile.
+1. [Create a Policy Rule](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) to apply the Data Sandbox Profile.
 
 1. Define the Coder Application group as the Destination Object.
 
 1. Define the Data Sandbox Profile as the Action in the Last Mile Protection
    section.
 
-### Conditionally allow copy on Coder&rsquo;s CLI authentication page
+### Conditionally allow copy on Coder's CLI authentication page
 
-1. [Create a URL Object][policy-rule] with the following configuration.
+1. [Create a URL Object](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) with the following configuration.
 
    - **Include**
    - **URL type**: Wildcard
    - **URL address**: `coder.example.com/cli-auth`
    - **Casing**: Insensitive
 
-1. [Create a Data Sandbox Profile][data-sandbox].
+1. [Create a Data Sandbox Profile](https://documentation.island.io/docs/create-and-configure-a-data-sandbox-profile).
 
 1. Configure action to allow copy/paste.
 
-1. [Create a Policy Rule][policy-rule] to apply the Data Sandbox Profile.
+1. [Create a Policy Rule](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) to apply the Data Sandbox Profile.
 
 1. Define the URL Object you created as the Destination Object.
 
@@ -80,10 +80,10 @@ ensuring that sensitive IP remains in your centralized environment.
 
 1. Create a Protection Profiles for both upload/download.
 
-   - [Upload documentation][upload-docs]
-   - [Download documentation][download-docs]
+   - [Upload documentation](https://documentation.island.io/docs/create-and-configure-an-upload-protection-profile)
+   - [Download documentation](https://documentation.island.io/v1/docs/en/create-and-configure-a-download-protection-profile)
 
-1. [Create a Policy Rule][policy-rule] to apply the Protection Profiles.
+1. [Create a Policy Rule](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) to apply the Protection Profiles.
 
 1. Define the Coder Application group as the Destination Object.
 
@@ -92,9 +92,9 @@ ensuring that sensitive IP remains in your centralized environment.
 
 ### Scan files for sensitive data
 
-1. [Create a Data Loss Prevention scanner][dlp-scanner].
+1. [Create a Data Loss Prevention scanner](https://documentation.island.io/docs/create-a-data-loss-prevention-scanner).
 
-1. [Create a Policy Rule][policy-rule] to apply the DLP Scanner.
+1. [Create a Policy Rule](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) to apply the DLP Scanner.
 
 1. Define the Coder Application group as the Destination Object.
 
@@ -103,7 +103,7 @@ ensuring that sensitive IP remains in your centralized environment.
 ## Application Awareness and Boundaries
 
 Ensure that Coder is only accessed through the Island browser, guaranteeing that
-your browser-level DLP policies are always enforced, and developers can&rsquo;t
+your browser-level DLP policies are always enforced, and developers can't
 sidestep such policies simply by using another browser.
 
 ### Configure browser enforcement, conditional access policies
@@ -114,9 +114,9 @@ sidestep such policies simply by using another browser.
    The configured IdP must be the same for both Coder and Island
    </blockquote>
 
-   - [Azure Active Directory/Entra ID][island-entra]
-   - [Okta][island-okta]
-   - [Google][island-google]
+   - [Azure Active Directory/Entra ID](https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-azure-ad#create-and-apply-a-conditional-access-policy)
+   - [Okta](https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-okta)
+   - [Google](https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-google-enterprise)
 
 ## Browser Activity Logging
 
@@ -125,7 +125,7 @@ screenshots, mouse clicks, and keystrokes.
 
 ### Activity Logging Module
 
-1. [Create an Activity Logging Profile][logging-profile]. Supported browser
+1. [Create an Activity Logging Profile](https://documentation.island.io/docs/create-and-configure-an-activity-logging-profile). Supported browser
    events include:
 
    - Web Navigation
@@ -138,7 +138,7 @@ screenshots, mouse clicks, and keystrokes.
    - Mouse Clicks
    - Keystrokes
 
-1. [Create a Policy Rule][policy-rule] to apply the Activity Logging Profile.
+1. [Create a Policy Rule](https://documentation.island.io/docs/create-and-configure-a-policy-rule-general) to apply the Activity Logging Profile.
 
 1. Define the Coder Application group as the Destination Object.
 
@@ -147,38 +147,12 @@ screenshots, mouse clicks, and keystrokes.
 
 ## Identity-aware logins (SSO)
 
-Integrate Island&rsquo;s identity management system with Coder&rsquo;s
+Integrate Island's identity management system with Coder's
 authentication mechanisms to enable identity-aware logins.
 
 ### Configure single sign-on (SSO) seamless authentication between Coder and Island
 
 Configure the same identity provider (IdP) for both your Island and Coder
-deployment. Upon initial login to the Island browser, the user&rsquo;s session
+deployment. Upon initial login to the Island browser, the user's session
 token will automatically be passed to Coder and authenticate their Coder
 session.
-
-<!-- Reference links -->
-
-[island]: https://www.island.io/
-[app-group]:
-	https://documentation.island.io/docs/create-and-configure-an-application-group-object
-[data-sandbox]:
-	https://documentation.island.io/docs/create-and-configure-a-data-sandbox-profile
-[policy-rule]:
-	https://documentation.island.io/docs/create-and-configure-a-policy-rule-general
-[url-object]:
-	https://documentation.island.io/docs/create-and-configure-a-policy-rule-general
-[logging-profile]:
-	https://documentation.island.io/docs/create-and-configure-an-activity-logging-profile
-[dlp-scanner]:
-	https://documentation.island.io/docs/create-a-data-loss-prevention-scanner
-[upload-docs]:
-	https://documentation.island.io/docs/create-and-configure-an-upload-protection-profile
-[download-docs]:
-	https://documentation.island.io/v1/docs/en/create-and-configure-a-download-protection-profile
-[island-entra]:
-	https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-azure-ad#create-and-apply-a-conditional-access-policy
-[island-okta]:
-	https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-okta
-[island-google]:
-	https://documentation.island.io/docs/configure-browser-enforcement-for-island-with-google-enterprise
diff --git a/docs/admin/integrations/jfrog-artifactory.md b/docs/admin/integrations/jfrog-artifactory.md
@@ -134,7 +134,7 @@ To set this up, follow these steps:
    <blockquote class="info">
 
    The admin-level access token is used to provision user tokens and is never exposed to developers or stored in workspaces.
-   
+
    </blockquote>
 
 If you don't want to use the official modules, you can read through the [example
diff --git a/docs/admin/integrations/jfrog-xray.md b/docs/admin/integrations/jfrog-xray.md
@@ -11,8 +11,8 @@ March 17, 2024
 
 ---
 
-This guide describes the process of integrating [JFrog Xray][] to Coder Kubernetes-backed
-workspaces using Coder&rsquo;s [JFrog Xray Integration][`coder-xray`].
+This guide describes the process of integrating [JFrog Xray](https://jfrog.com/xray/) to Coder Kubernetes-backed
+workspaces using Coder's [JFrog Xray Integration](https://github.com/coder/coder-xray).
 
 ## Prerequisites
 
@@ -21,10 +21,10 @@ workspaces using Coder&rsquo;s [JFrog Xray Integration][`coder-xray`].
 
 ## Deploy the **Coder - JFrog Xray** Integration
 
-1. Create a JFrog Platform [Access Token][] with a user that has the `read` [permission][]
+1. Create a JFrog Platform [Access Token](https://jfrog.com/help/r/jfrog-platform-administration-documentation/access-tokens) with a user that has the `read` [permission](https://jfrog.com/help/r/jfrog-platform-administration-documentation/permissions)
    for the repositories you want to scan.
 
-1. Create a Coder [token][] with a user that has the [`owner`][roles] role.
+1. Create a Coder [token](../../reference/cli/tokens_create.md#tokens-create) with a user that has the [`owner`](../users#roles) role.
 
 1. Create Kubernetes secrets for the JFrog Xray and Coder tokens.
 
@@ -58,10 +58,9 @@ workspaces using Coder&rsquo;s [JFrog Xray Integration][`coder-xray`].
 
    <blockquote class="admonition warning">
 
-   **Note**: To authenticate with the Artifactory registry, you may need to
-   create a [Docker config][docker-advanced-topics] and use it in the
-   `imagePullSecrets` field of the Kubernetes Pod. See the [**Defining
-   ImagePullSecrets for Coder workspaces**][image-pull-secret] guide for more
+   To authenticate with the Artifactory registry, you may need to
+   create a [Docker config](https://jfrog.com/help/r/jfrog-artifactory-documentation/docker-advanced-topics) and use it in the
+   `imagePullSecrets` field of the Kubernetes Pod. See the [Defining ImagePullSecrets for Coder workspaces](../../tutorials/image-pull-secret.md) guide for more
    information.
 
    </blockquote>
@@ -72,18 +71,3 @@ Once installed, configured workspaces will now have a banner appear on any
 workspace with vulnerabilities reported by JFrog Xray.
 
 <img alt="JFrog Xray Integration" src="../../images/guides/xray-integration/example.png" />
-
-<!-- References -->
-
-[JFrog Xray]: https://jfrog.com/xray/
-[JFrog Xray Integration]: https://github.com/coder/coder-xray
-[`coder-xray`]: https://github.com/coder/coder-xray
-[docker-advanced-topics]:
-	https://jfrog.com/help/r/jfrog-artifactory-documentation/docker-advanced-topics
-[image-pull-secret]: ../../tutorials/image-pull-secret.md
-[token]: ../../reference/cli/tokens_create.md#tokens-create
-[roles]: ../users#roles
-[permission]:
-	https://jfrog.com/help/r/jfrog-platform-administration-documentation/permissions
-[access token]:
-	https://jfrog.com/help/r/jfrog-platform-administration-documentation/access-tokens
diff --git a/docs/admin/integrations/prometheus.md b/docs/admin/integrations/prometheus.md
@@ -4,7 +4,7 @@ Coder exposes many metrics which can be consumed by a Prometheus server, and
 give insight into the current state of a live Coder deployment.
 
 If you don't have a Prometheus server installed, you can follow the Prometheus
-[Getting started][prom-get-started] guide.
+[Getting started](https://prometheus.io/docs/prometheus/latest/getting_started/) guide.
 
 ## Enable Prometheus metrics
 
@@ -18,7 +18,7 @@ use either the environment variable `CODER_PROMETHEUS_ADDRESS` or the flag
 address.
 
 If `coder server --prometheus-enable` is started locally, you can preview the
-metrics endpoint in your browser or by using curl.
+metrics endpoint in your browser or with `curl`:
 
 ```console
 $ curl http://localhost:2112/
@@ -30,7 +30,7 @@ coderd_api_active_users_duration_hour 0
 
 ### Kubernetes deployment
 
-The Prometheus endpoint can be enabled in the [Helm chart's][coder-helm]
+The Prometheus endpoint can be enabled in the [Helm chart's](https://github.com/coder/coder/tree/main/helm)
 `values.yml` by setting the environment variable `CODER_PROMETHEUS_ADDRESS` to
 `0.0.0.0:2112`. The environment variable `CODER_PROMETHEUS_ENABLE` will be
 enabled automatically. A Service Endpoint will not be exposed; if you need to
@@ -100,12 +100,6 @@ You must first enable `coderd_agentstats_*` with the flag
 `CODER_PROMETHEUS_COLLECT_AGENT_STATS` before they can be retrieved from the
 deployment. They will always be available from the agent.
 
-<!-- References -->
-
-[prom-get-started]:
-	https://prometheus.io/docs/prometheus/latest/getting_started/
-[coder-helm]: https://github.com/coder/coder/tree/main/helm
-
 <!-- Code generated by 'make docs/admin/integrations/prometheus.md'. DO NOT EDIT -->
 
 | Name                                                          | Type      | Description                                                                                                                      | Labels                                                                               |
diff --git a/docs/admin/integrations/vault.md b/docs/admin/integrations/vault.md
@@ -11,17 +11,17 @@ August 05, 2024
 
 ---
 
-This guide describes the process of integrating [HashiCorp Vault][] into Coder workspaces.
+This guide describes the process of integrating [HashiCorp Vault](https://www.vaultproject.io/) into Coder workspaces.
 
 Coder makes it easy to integrate HashiCorp Vault with your workspaces by
 providing official Terraform modules to integrate Vault with Coder. This guide
 will show you how to use these modules to integrate HashiCorp Vault with Coder.
 
 ## The `vault-github` module
 
-The [`vault-github`][] module is a Terraform module that allows you to
+The [`vault-github`](https://registry.coder.com/modules/vault-github) module is a Terraform module that allows you to
 authenticate with Vault using a GitHub token. This module uses the existing
-GitHub [external authentication][] to get the token and authenticate with Vault.
+GitHub [external authentication](../external-auth.md) to get the token and authenticate with Vault.
 
 To use this module, add the following code to your Terraform configuration.
 
@@ -43,9 +43,3 @@ a secret stored in the KV backend.
 ```shell
 vault kv get -namespace=YOUR_NAMESPACE -mount=MOUNT_NAME SECRET_NAME
 ```
-
-<!-- References -->
-
-[HashiCorp Vault]: https://www.vaultproject.io/
-[external authentication]: ../external-auth.md
-[`vault-github`]: https://registry.coder.com/modules/vault-github
