coder · khorne3 · Jun 21, 2021 · Jun 18, 2021 · Jun 18, 2021 · Jun 21, 2021
diff --git a/admin/access-control/password-reset.md b/admin/access-control/password-reset.md
@@ -11,7 +11,7 @@ To reset a user's password:
 1. Click **Reset password**. Coder will display a temporary password that you
    can provide to the user. Click **Reset Password** to proceed with the reset.
 
-![Confirm password reset](../../assets/reset-password.png)
+![Confirm password reset](../../assets/admin/reset-password.png)
 
 When the user logs in using the temporary password, Coder will prompt them to
 change it.

diff --git a/admin/account-dormancy.md b/admin/account-dormancy.md
@@ -11,4 +11,4 @@ For example, you can set Coder to delete accounts 30 days after they go dormant
 (this means that the user has been inactive for 120 days: 90 days to become
 dormant, plus an additional 30 days).
 
-![Account dormancy](../assets/account-dormancy.png)
+![Account dormancy](../assets/admin/account-dormancy.png)
diff --git a/admin/appearance.md b/admin/appearance.md
@@ -18,7 +18,7 @@ To customize your system banner messages:
    in your **Header** and **Footer**.
 1. Click **Save Preferences** to save your changes.
 
-![System appearance](../assets/system-banners.png)
+![System appearance](../assets/admin/system-banners.png)
 
 ## Terms of service
 
@@ -30,7 +30,7 @@ To enable the display of terms of service and to edit the text displayed:
    Markdown formatting.
 1. Click **Save Preferences** to save your changes.
 
-![Terms of service](../assets/terms-of-service.png)
+![Terms of service](../assets/admin/terms-of-service.png)
 
 **Note**: If you enable the use of terms of service, users will not be able to
 log in to Coder without first accepting the terms of service.
diff --git a/admin/audit.md b/admin/audit.md
@@ -13,7 +13,7 @@ Any user who is a **Site Manager** or an **Auditor** can log into Coder, go to
 By default, this page displays a chronological list of all actions taken on the
 system.
 
-![Audit logs](../assets/audit-log.png)
+![Audit logs](../assets/admin/audit-log.png)
 
 You can filter the logs displayed using the search filters available at the top:
 

diff --git a/admin/devurls.md b/admin/devurls.md
@@ -82,7 +82,7 @@ scroll down to **Dev URL Access Permissions**.
   </tr>
 </table>
 
-![Setting dev URL permissions](../assets/admin-devurl-permissions.png)
+![Setting dev URL permissions](../assets/admin/admin-devurl-permissions.png)
 
 You can set the maximum access level, but developers may choose to restrict
 access further.

diff --git a/admin/git.md b/admin/git.md
@@ -26,7 +26,7 @@ However, Coder doesn't test these and cannot provide recommendations or support.
 **Note** The public key provided by Coder uses the ECDSA key algorithm. Ensure
 your git provider supports this.
 
-![Configure Git Integration](../assets/git-admin.png)
+![Configure Git Integration](../assets/admin/git-admin.png)
 
 ## Configuring OAuth
 

diff --git a/admin/metrics.md b/admin/metrics.md
@@ -6,4 +6,4 @@ description: Learn how to track usage of your Coder deployment.
 Metrics allow you to track the number of people using Coder on a day-to-day
 basis. Access the following view from **Manage > Metrics**.
 
-![Metrics UI](../assets/metrics.png)
+![Metrics UI](../assets/admin/metrics.png)
diff --git a/admin/organizations.md b/admin/organizations.md
@@ -25,7 +25,7 @@ can also change which organizations are defaults at any time.
 [Site admins and site managers](access-control/user-roles.md) can create new
 organizations by going to **Manage** > **Organizations** > **New Organization**.
 
-![Create a new organization dialog](../assets/create-an-org.png)
+![Create a new organization dialog](../assets/admin/create-an-org.png)
 
 Provide a **name** and (optionally) a **description** for this organization. If
 you want this to become a **Default organization**, make sure to check the
@@ -52,7 +52,7 @@ When you've set your parameters, click **Create** to proceed.
 You can edit an organization at any time by going to **Manage** >
 **Organizations**.
 
-![Edit an organization dialog](../assets/edit-an-org.png)
+![Edit an organization dialog](../assets/admin/edit-an-org.png)
 
 Find the organization you want to edit, and click to open. In the top-right,
 click **Edit** to launch the **Edit Organizations** dialog.

diff --git a/admin/registries/default-registry.md b/admin/registries/default-registry.md
@@ -26,4 +26,4 @@ To do so:
    option.
 1. Click **Save Registry**.
 
-![Import default registry](../../assets/import-default-registry.png)
+![Import default registry](../../assets/admin/import-default-registry.png)
diff --git a/admin/telemetry.md b/admin/telemetry.md
@@ -13,7 +13,7 @@ Reports**, **Send Usage Telemetry**, or **Send Enhanced Usage Telemetry**.
 
 Be sure to click **Save Preferences** after you make your changes.
 
-![Telemetry](../assets/telemetry.png)
+![Telemetry](../assets/admin/telemetry.png)
 
 > You cannot modify the default telemetry settings during a
 > [free trial](https://coder.com/trial) of Coder or by those with evaluation

diff --git a/admin/templates.md b/admin/templates.md
@@ -17,12 +17,12 @@ To create your button:
 Once you've filled out the form, Coder generates a custom Markdown snippet,
 which you can then add to your repository's `README.md`.
 
-![Open In Coder Button](../assets/wac-badge.png)
+![Open In Coder Button](../assets/admin/wac-badge.png)
 
 ## Enabling workspaces as code
 
 By default, workspaces as code is an opt-in feature. To enable workspaces as
 code, go to **Admin > Templates** and set **Enable using Workspace Templates**
 to **On**.
 
-![toggle workspaces as code](../assets/wac_toggle.png)
+![toggle workspaces as code](../assets/admin/wac_toggle.png)
diff --git a/admin/workspace-management/extensions.md b/admin/workspace-management/extensions.md
@@ -18,7 +18,7 @@ then scrolling down to **Extensions**:
 - **Custom**: your organization's custom VS Code extension marketplace API,
   accessed via the URL you provide
 
-![Configuring extensions marketplace](../../assets/configure-extensions.png)
+![Configuring extensions marketplace](../../assets/admin/configure-extensions.png)
 
 ## Air-gapped marketplaces
 

diff --git a/admin/workspace-management/gpu-acceleration.md b/admin/workspace-management/gpu-acceleration.md
@@ -21,4 +21,4 @@ Go to **Manage** > **Admin**. On the **Infrastructure** tab, find the **GPU
 Vendor** setting, and change it to the GPU vendor of choice (either **AMD** or
 **Nvidia**). Click **Save Vendor**.
 
-![Enable GPU vendor](../../assets/gpu.png)
+![Enable GPU vendor](../../assets/admin/gpu.png)
diff --git a/admin/workspace-management/memory-overprovisioning.md b/admin/workspace-management/memory-overprovisioning.md
@@ -15,7 +15,7 @@ A site admin/manager must complete these steps:
 1. Under the **Infrastructure** tab, check the box next to **Enable Memory
    Overprovisioning**.
 
-![Enable memory overprovisioning](../../assets/enable-memory-overprovisioning.png)
+![Enable memory overprovisioning](../../assets/admin/enable-memory-overprovisioning.png)
 
 ## Step 2: Changing the memory provisioning rate
 
@@ -24,4 +24,4 @@ A site admin/manager must complete these steps:
    down to **Memory Provisioning Rate** and set the maximum ratio
 1. Click **Update**.
 
-![Set memory overprovisioning ratios](../../assets/set-memory-ratios.png)
+![Set memory overprovisioning ratios](../../assets/admin/set-memory-ratios.png)
diff --git a/admin/workspace-management/shutdown.md b/admin/workspace-management/shutdown.md
@@ -26,4 +26,4 @@ Click **Edit** in the top-right. In the dialog that opens, use the slider
 underneath **Workspace Shutdown Behavior** to select the maximum allowed
 duration.
 
-![Configure shutdown behavior](../../assets/workspace-shutdown.png)
+![Configure shutdown behavior](../../assets/admin/workspace-shutdown.png)
diff --git a/admin/workspace-providers/deployment.md b/admin/workspace-providers/deployment.md
@@ -139,7 +139,7 @@ when communicating with the Coder deployment.
 1. Once the Helm chart has deployed successfully, you should see the workspace
    provider in a `ready` state on the **Workspace provider admin** page.
 
-   ![Workspace providers admin](../../assets/workspace-providers-admin.png)
+   ![Workspace providers admin](../../assets/admin/workspace-providers-admin.png)
 
 1. From the **Workspace provider admin** page, add the desired organizations to
    its allowlist.

diff --git a/admin/workspace-providers/index.md b/admin/workspace-providers/index.md
@@ -41,7 +41,7 @@ expand your Coder deployment to additional Kubernetes clusters.
 Site admins and site managers can view the workspace providers configuration
 page available via **Manage** > **Admin** > **Workspace Providers**.
 
-![Workspace providers admin](../../assets/workspace-providers-admin.png)
+![Workspace providers admin](../../assets/admin/workspace-providers-admin.png)
 
 The Admin panel shows an overview of all configured workspace providers and
 indicates their statuses and details. The **default** tag indicates the provider
@@ -51,7 +51,7 @@ that will be selected by default when a user creates a workspace using the
 You can expand individual listings to view in-depth information:
 
 ![Detailed workspace providers
-info](../../assets/workspace-providers-detail.png)
+info](../../assets/admin/workspace-providers-detail.png)
 
 ### Status
 

diff --git a/assets/account-dormancy.png → assets/admin/account-dormancy.png b/assets/account-dormancy.png → assets/admin/account-dormancy.png
diff --git a/assets/admin-devurl-permissions.png → assets/admin/admin-devurl-permissions.png b/assets/admin-devurl-permissions.png → assets/admin/admin-devurl-permissions.png
diff --git a/assets/audit-log.png → assets/admin/audit-log.png b/assets/audit-log.png → assets/admin/audit-log.png
diff --git a/assets/configure-extensions.png → assets/admin/configure-extensions.png b/assets/configure-extensions.png → assets/admin/configure-extensions.png
diff --git a/assets/create-an-org.png → assets/admin/create-an-org.png b/assets/create-an-org.png → assets/admin/create-an-org.png
diff --git a/assets/edit-an-org.png → assets/admin/edit-an-org.png b/assets/edit-an-org.png → assets/admin/edit-an-org.png
diff --git a/assets/enable-memory-overprovisioning.png → .../admin/enable-memory-overprovisioning.png b/assets/enable-memory-overprovisioning.png → .../admin/enable-memory-overprovisioning.png
diff --git a/assets/git-admin.png → assets/admin/git-admin.png b/assets/git-admin.png → assets/admin/git-admin.png
diff --git a/assets/gpu.png → assets/admin/gpu.png b/assets/gpu.png → assets/admin/gpu.png
diff --git a/assets/import-default-registry.png → assets/admin/import-default-registry.png b/assets/import-default-registry.png → assets/admin/import-default-registry.png
diff --git a/assets/metrics.png → assets/admin/metrics.png b/assets/metrics.png → assets/admin/metrics.png
diff --git a/assets/reset-password.png → assets/admin/reset-password.png b/assets/reset-password.png → assets/admin/reset-password.png
diff --git a/assets/set-memory-ratios.png → assets/admin/set-memory-ratios.png b/assets/set-memory-ratios.png → assets/admin/set-memory-ratios.png
diff --git a/assets/system-banners.png → assets/admin/system-banners.png b/assets/system-banners.png → assets/admin/system-banners.png
diff --git a/assets/telemetry.png → assets/admin/telemetry.png b/assets/telemetry.png → assets/admin/telemetry.png
diff --git a/assets/terms-of-service.png → assets/admin/terms-of-service.png b/assets/terms-of-service.png → assets/admin/terms-of-service.png
diff --git a/assets/wac-badge.png → assets/admin/wac-badge.png b/assets/wac-badge.png → assets/admin/wac-badge.png
diff --git a/assets/wac_toggle.png → assets/admin/wac_toggle.png b/assets/wac_toggle.png → assets/admin/wac_toggle.png
diff --git a/assets/workspace-providers-admin.png → assets/admin/workspace-providers-admin.png b/assets/workspace-providers-admin.png → assets/admin/workspace-providers-admin.png
diff --git a/assets/workspace-providers-detail.png → assets/admin/workspace-providers-detail.png b/assets/workspace-providers-detail.png → assets/admin/workspace-providers-detail.png
diff --git a/assets/workspace-shutdown.png → assets/admin/workspace-shutdown.png b/assets/workspace-shutdown.png → assets/admin/workspace-shutdown.png
diff --git a/assets/app-registration.png → assets/guides/admin/app-registration.png b/assets/app-registration.png → assets/guides/admin/app-registration.png
diff --git a/assets/client-id.png → assets/guides/admin/client-id.png b/assets/client-id.png → assets/guides/admin/client-id.png
diff --git a/assets/client-secret.png → assets/guides/admin/client-secret.png b/assets/client-secret.png → assets/guides/admin/client-secret.png
diff --git a/assets/compute-1.png → assets/guides/admin/compute-1.png b/assets/compute-1.png → assets/guides/admin/compute-1.png
diff --git a/assets/compute-2.png → assets/guides/admin/compute-2.png b/assets/compute-2.png → assets/guides/admin/compute-2.png
diff --git a/assets/compute-3.png → assets/guides/admin/compute-3.png b/assets/compute-3.png → assets/guides/admin/compute-3.png
diff --git a/assets/compute-4.png → assets/guides/admin/compute-4.png b/assets/compute-4.png → assets/guides/admin/compute-4.png
diff --git a/assets/compute-5.png → assets/guides/admin/compute-5.png b/assets/compute-5.png → assets/guides/admin/compute-5.png
diff --git a/assets/compute-6.png → assets/guides/admin/compute-6.png b/assets/compute-6.png → assets/guides/admin/compute-6.png
diff --git a/assets/compute-7.png → assets/guides/admin/compute-7.png b/assets/compute-7.png → assets/guides/admin/compute-7.png
diff --git a/assets/cpu_provision_ratio.png → assets/guides/admin/cpu_provision_ratio.png b/assets/cpu_provision_ratio.png → assets/guides/admin/cpu_provision_ratio.png
diff --git a/assets/issuer.png → assets/guides/admin/issuer.png b/assets/issuer.png → assets/guides/admin/issuer.png
diff --git a/assets/okta-add-app.jpg → assets/guides/admin/okta-add-app.jpg b/assets/okta-add-app.jpg → assets/guides/admin/okta-add-app.jpg
diff --git a/assets/okta-assign-app.jpg → assets/guides/admin/okta-assign-app.jpg b/assets/okta-assign-app.jpg → assets/guides/admin/okta-assign-app.jpg
diff --git a/assets/okta-client-id-and-secret.jpg → ...uides/admin/okta-client-id-and-secret.jpg b/assets/okta-client-id-and-secret.jpg → ...uides/admin/okta-client-id-and-secret.jpg
diff --git a/assets/okta-create-new-app.jpg → assets/guides/admin/okta-create-new-app.jpg b/assets/okta-create-new-app.jpg → assets/guides/admin/okta-create-new-app.jpg
diff --git a/assets/okta-create-openid-integration.jpg → .../admin/okta-create-openid-integration.jpg b/assets/okta-create-openid-integration.jpg → .../admin/okta-create-openid-integration.jpg
diff --git a/assets/okta-custom-app-creation.jpg → ...guides/admin/okta-custom-app-creation.jpg b/assets/okta-custom-app-creation.jpg → ...guides/admin/okta-custom-app-creation.jpg
diff --git a/assets/okta-issuer.jpg → assets/guides/admin/okta-issuer.jpg b/assets/okta-issuer.jpg → assets/guides/admin/okta-issuer.jpg
diff --git a/assets/register.png → assets/guides/admin/register.png b/assets/register.png → assets/guides/admin/register.png
diff --git a/assets/resources-new.svg → assets/guides/admin/resources-new.svg b/assets/resources-new.svg → assets/guides/admin/resources-new.svg
diff --git a/assets/resources-old.svg → assets/guides/admin/resources-old.svg b/assets/resources-old.svg → assets/guides/admin/resources-old.svg
diff --git a/assets/macos-keybinding.png → ...guides/customization/macos-keybinding.png b/assets/macos-keybinding.png → ...guides/customization/macos-keybinding.png
diff --git a/assets/SAML-config-1.png → assets/guides/deployments/SAML-config-1.png b/assets/SAML-config-1.png → assets/guides/deployments/SAML-config-1.png
diff --git a/assets/SAML-config-2.png → assets/guides/deployments/SAML-config-2.png b/assets/SAML-config-2.png → assets/guides/deployments/SAML-config-2.png
diff --git a/assets/SAML-process.png → assets/guides/deployments/SAML-process.png b/assets/SAML-process.png → assets/guides/deployments/SAML-process.png
diff --git a/assets/applications.png → assets/guides/deployments/applications.png b/assets/applications.png → assets/guides/deployments/applications.png
diff --git a/assets/keycloak-IdP-redirector.png → ...s/deployments/keycloak-IdP-redirector.png b/assets/keycloak-IdP-redirector.png → ...s/deployments/keycloak-IdP-redirector.png
diff --git a/assets/keycloak-add-client.png → ...uides/deployments/keycloak-add-client.png b/assets/keycloak-add-client.png → ...uides/deployments/keycloak-add-client.png
diff --git a/assets/keycloak-authenticator-config.png → ...oyments/keycloak-authenticator-config.png b/assets/keycloak-authenticator-config.png → ...oyments/keycloak-authenticator-config.png
diff --git a/assets/keycloak-client-config.png → ...es/deployments/keycloak-client-config.png b/assets/keycloak-client-config.png → ...es/deployments/keycloak-client-config.png
diff --git a/assets/keycloak-coder-config.png → ...des/deployments/keycloak-coder-config.png b/assets/keycloak-coder-config.png → ...des/deployments/keycloak-coder-config.png
diff --git a/assets/keycloak-create-client.png → ...es/deployments/keycloak-create-client.png b/assets/keycloak-create-client.png → ...es/deployments/keycloak-create-client.png
diff --git a/assets/keycloak-default-IdP.png → ...ides/deployments/keycloak-default-IdP.png b/assets/keycloak-default-IdP.png → ...ides/deployments/keycloak-default-IdP.png
diff --git a/assets/keycloak-identity-providers.png → ...ployments/keycloak-identity-providers.png b/assets/keycloak-identity-providers.png → ...ployments/keycloak-identity-providers.png
diff --git a/assets/keycloak-metadata-import.png → .../deployments/keycloak-metadata-import.png b/assets/keycloak-metadata-import.png → .../deployments/keycloak-metadata-import.png
diff --git a/assets/keycloak-secret.png → ...ts/guides/deployments/keycloak-secret.png b/assets/keycloak-secret.png → ...ts/guides/deployments/keycloak-secret.png
diff --git a/assets/manage-users.png → assets/guides/deployments/manage-users.png b/assets/manage-users.png → assets/guides/deployments/manage-users.png
diff --git a/assets/android-avd.png → ...guides/mobile-development/android-avd.png b/assets/android-avd.png → ...guides/mobile-development/android-avd.png
diff --git a/assets/android-sdk-missing.png → ...obile-development/android-sdk-missing.png b/assets/android-sdk-missing.png → ...obile-development/android-sdk-missing.png
diff --git a/assets/android-sdk-path.png → ...s/mobile-development/android-sdk-path.png b/assets/android-sdk-path.png → ...s/mobile-development/android-sdk-path.png
diff --git a/assets/cloudflare-1.png → .../guides/ssl-certificates/cloudflare-1.png b/assets/cloudflare-1.png → .../guides/ssl-certificates/cloudflare-1.png
diff --git a/assets/configure.png → assets/images/configure.png b/assets/configure.png → assets/images/configure.png
diff --git a/assets/default-tag.png → assets/images/default-tag.png b/assets/default-tag.png → assets/images/default-tag.png
diff --git a/assets/deprecate-image.png → assets/images/deprecate-image.png b/assets/deprecate-image.png → assets/images/deprecate-image.png
diff --git a/assets/embed-1.png → assets/images/embed-1.png b/assets/embed-1.png → assets/images/embed-1.png
diff --git a/assets/embed-2.png → assets/images/embed-2.png b/assets/embed-2.png → assets/images/embed-2.png
diff --git a/assets/existing-tag-as-default.png → assets/images/existing-tag-as-default.png b/assets/existing-tag-as-default.png → assets/images/existing-tag-as-default.png
diff --git a/assets/import-image.png → assets/images/import-image.png b/assets/import-image.png → assets/images/import-image.png
diff --git a/assets/org-resources.png b/assets/org-resources.png
diff --git a/assets/pwa.png b/assets/pwa.png
diff --git a/assets/architecture.png → assets/setup/architecture.png b/assets/architecture.png → assets/setup/architecture.png
diff --git a/assets/licensing.png → assets/setup/licensing.png b/assets/licensing.png → assets/setup/licensing.png
diff --git a/assets/workspace-providers-org-whitelist.png b/assets/workspace-providers-org-whitelist.png
diff --git a/assets/advanced-workspace-config.png → .../workspaces/advanced-workspace-config.png b/assets/advanced-workspace-config.png → .../workspaces/advanced-workspace-config.png
diff --git a/assets/autostart_save_preferences.png → ...workspaces/autostart_save_preferences.png b/assets/autostart_save_preferences.png → ...workspaces/autostart_save_preferences.png
diff --git a/assets/create-devurl.png → assets/workspaces/create-devurl.png b/assets/create-devurl.png → assets/workspaces/create-devurl.png
diff --git a/assets/create-workspace.png → assets/workspaces/create-workspace.png b/assets/create-workspace.png → assets/workspaces/create-workspace.png
diff --git a/assets/cvm-create.png → assets/workspaces/cvm-create.png b/assets/cvm-create.png → assets/workspaces/cvm-create.png
diff --git a/assets/devurls.png → assets/workspaces/devurls.png b/assets/devurls.png → assets/workspaces/devurls.png
diff --git a/assets/dotfiles-preferences.png → assets/workspaces/dotfiles-preferences.png b/assets/dotfiles-preferences.png → assets/workspaces/dotfiles-preferences.png
diff --git a/assets/enable-autostart.png → assets/workspaces/enable-autostart.png b/assets/enable-autostart.png → assets/workspaces/enable-autostart.png
diff --git a/assets/launch-workspace.png → assets/workspaces/launch-workspace.png b/assets/launch-workspace.png → assets/workspaces/launch-workspace.png
diff --git a/assets/personalize-log.png → assets/workspaces/personalize-log.png b/assets/personalize-log.png → assets/workspaces/personalize-log.png
diff --git a/assets/set_autostart_time.png → assets/workspaces/set_autostart_time.png b/assets/set_autostart_time.png → assets/workspaces/set_autostart_time.png
diff --git a/assets/vscode-remote-ssh-panel.png → ...ts/workspaces/vscode-remote-ssh-panel.png b/assets/vscode-remote-ssh-panel.png → ...ts/workspaces/vscode-remote-ssh-panel.png
diff --git a/assets/create-from-template.png → ...rkspaces-as-code/create-from-template.png b/assets/create-from-template.png → ...rkspaces-as-code/create-from-template.png
diff --git a/assets/wac-location.png → ...paces/workspaces-as-code/wac-location.png b/assets/wac-location.png → ...paces/workspaces-as-code/wac-location.png
diff --git a/assets/wac-user-form.png → ...aces/workspaces-as-code/wac-user-form.png b/assets/wac-user-form.png → ...aces/workspaces-as-code/wac-user-form.png
diff --git a/assets/workspaces.svg → assets/workspaces/workspaces.svg b/assets/workspaces.svg → assets/workspaces/workspaces.svg
diff --git a/guides/admin/oidc-azuread.md b/guides/admin/oidc-azuread.md
@@ -22,15 +22,15 @@ information you need to provide to Coder.
 1. Using the search bar at the top, enter **App registrations** and click the
    matching search result.
 
-   ![App registration](../../assets/app-registration.png)
+   ![App registration](../../assets/guides/admin/app-registration.png)
 
 1. Click **New registration**.
 1. Provide a **Name** for your application.
 1. Select the access option that best fits your needs; the **Default Directory
    only - Single tenant** option should be sufficient for testing, but you may
    need a **multitenant** option for production environments.
 
-   ![Register your app](../../assets/register.png)
+   ![Register your app](../../assets/guides/admin/register.png)
 
 1. Provide your **Redirect URL** (it will be formatted similar to
    `https://coder.exampleCo.com/oidc/callback`).
@@ -53,7 +53,7 @@ On your application's **Overview**, look for the **Application (client) ID**
 under the **Essentials** section. This is the value Coder expects as the
 **Client ID**.
 
-![Client ID](../../assets/client-id.png)
+![Client ID](../../assets/guides/admin/client-id.png)
 
 ### Client secret
 
@@ -67,14 +67,14 @@ You'll need to create the client secret. To do so:
 1. You'll be redirected back to the **Certificates & secrets** page; save the
    **Value** field string for use as your client secret.
 
-![Client secret value](../../assets/client-secret.png)
+![Client secret value](../../assets/guides/admin/client-secret.png)
 
 ### Issuer
 
 On your app's **Overview** page, click **Endpoints**. Find **OpenID Connect
 metadata document**, and copy the first 2/3s of this value.
 
-![Issuer](../../assets/issuer.png)
+![Issuer](../../assets/guides/admin/issuer.png)
 
 For example, if the full value is:
 

diff --git a/guides/admin/oidc-okta.md b/guides/admin/oidc-okta.md
@@ -21,22 +21,22 @@ information you need to provide to Coder.
 1. From the admin dashboard, click **Applications** and click the
    **Applications** sub-menu.
 
-   ![Okta Applications](../../assets/okta-add-app.jpg)
+   ![Okta Applications](../../assets/guides/admin/okta-add-app.jpg)
 
 1. Click **Add Application**.
 
-   ![Okta Add Application](../../assets/okta-create-new-app.jpg)
+   ![Okta Add Application](../../assets/guides/admin/okta-create-new-app.jpg)
 
 1. Click **Create New App**.
 
-   ![Okta Create Application Modal](../../assets/okta-custom-app-creation.jpg)
+   ![Okta Create Application Modal](../../assets/guides/admin/okta-custom-app-creation.jpg)
 
 1. Select **OpenID Connect** and click **Create**
 1. Fill in the **Application name** (i.e. `Coder`), optionally add a logo
 1. Add the **Login redirect URIs** for Coder (it will be formatted similar
    to `https://coder.my-company.com/oidc/callback`).
 
-   ![Okta Create OpenID Application](../../assets/okta-create-openid-integration.jpg)
+   ![Okta Create OpenID Application](../../assets/guides/admin/okta-create-openid-integration.jpg)
 
 1. Click **Save** to proceed.
 
@@ -56,20 +56,20 @@ Once you've saved your app, you can obtain your:
 On your application's **General** tab, look for the **Client ID** under
 the **Client Credentials** section. Below this is the **Client secret**.
 
-![Client ID and Secret](../../assets/okta-client-id-and-secret.jpg)
+![Client ID and Secret](../../assets/guides/admin/okta-client-id-and-secret.jpg)
 
 ### Issuer
 
 On your app's **Overview** page, click the **Sign On** tab. Find the
 **OpenID Connect ID Token** section, and copy the **Issuer**.
 
-![Issuer](../../assets/okta-issuer.jpg)
+![Issuer](../../assets/guides/admin/okta-issuer.jpg)
 
 ## Step 3: Assign People and/or Groups to Coder
 
 On your app's **Overview** page, click the **Assignments** tab.
 
-![Assignments](../../assets/okta-assign-app.jpg)
+![Assignments](../../assets/guides/admin/okta-assign-app.jpg)
 
 From here, you can assign People and Groups to the application to
 provide access to Coder.

diff --git a/guides/admin/resources.md b/guides/admin/resources.md
@@ -23,7 +23,7 @@ each machine would see 100% utilization of its resources. However, these
 processes are relatively quick, so the machine is underutilized the vast
 majority of the time.
 
-![resources-nonshared.svg](../../assets/resources-old.svg)
+![resources-nonshared.svg](../../assets/guides/admin/resources-old.svg)
 
 However, sharing resources can allow you to provide your developers with access
 to the computing resources while minimizing underutilization.
@@ -35,7 +35,7 @@ resources they need during peak load (e.g., compilation, build); this offers
 them a performant experience when required. However, the shared resources
 minimize resource underutilization.
 
-![resources-shared.svg](../../assets/resources-new.svg)
+![resources-shared.svg](../../assets/guides/admin/resources-new.svg)
 
 ## Resource contention
 
@@ -60,4 +60,4 @@ compute costs:
 - The Coder organization's workspace inactivity shutdown threshold
 - The magnitude and frequency of code compilation operations
 
-![cpu_provision_ratio.png](../../assets/cpu_provision_ratio.png)
+![cpu_provision_ratio.png](../../assets/guides/admin/cpu_provision_ratio.png)
diff --git a/guides/admin/usage-monitoring.md b/guides/admin/usage-monitoring.md
@@ -16,9 +16,9 @@ contention can result in the throttling of developer workspaces, while excessive
 underutilization suggests that you may be spending more on your cloud workspace
 than necessary.
 
-![Monitoring CPU utilization](../../assets/compute-1.png)
+![Monitoring CPU utilization](../../assets/guides/admin/compute-1.png)
 
-![Monitoring Memory utilization](../../assets/compute-2.png)
+![Monitoring Memory utilization](../../assets/guides/admin/compute-2.png)
 
 There are several tools available to you to balance the tradeoff between
 workspace performance and cloud cost. Read more about this on
@@ -31,9 +31,9 @@ cluster resources to Coder's product-level resource identifiers. For example,
 the following chart tracks the CPU/Memory Limit Utilization of each workspace
 container and labels them with the username and workspace name identifiers:
 
-![Monitoring CPU Utilization by workspace and user](../../assets/compute-3.png)
+![Monitoring CPU Utilization by workspace and user](../../assets/guides/admin/compute-3.png)
 
-![Monitoring Memory Utilization by workspace and user](../../assets/compute-4.png)
+![Monitoring Memory Utilization by workspace and user](../../assets/guides/admin/compute-4.png)
 
 These views can help you track which users may require larger CPU allocations,
 enabling greater "burst-ability" under peak loads. However, remember that using
@@ -47,8 +47,8 @@ Monitoring the Coder control plane can help you maintain high uptime. For
 example, the following charts provide high-level insight into the state of the
 Coder API server:
 
-![Monitoring log event severity](../../assets/compute-5.png)
+![Monitoring log event severity](../../assets/guides/admin/compute-5.png)
 
-![Monitoring API status codes](../../assets/compute-6.png)
+![Monitoring API status codes](../../assets/guides/admin/compute-6.png)
 
-![Monitoring HTTP latency](../../assets/compute-7.png)
+![Monitoring HTTP latency](../../assets/guides/admin/compute-7.png)
diff --git a/guides/customization/macos-keybinding.md b/guides/customization/macos-keybinding.md
@@ -16,4 +16,4 @@ To switch the keybindings:
 1. Use the **Keymap** toggle at the top to switch to **macOS**
 1. Click **OK** to save your changes and proceed
 
-![Configuring macOS keybindings](../../assets/macos-keybinding.png)
+![Configuring macOS keybindings](../../assets/guides/customization/macos-keybinding.png)
diff --git a/guides/deployments/code-server.md b/guides/deployments/code-server.md
@@ -14,7 +14,7 @@ addition to the base code-server functionality.
 - [Manage and distribute workspace images](https://coder.com/docs/images)
 - [Build custom workspaces that include your project's dependencies](https://coder.com/docs/images/structure)
 
-![Coder Dashboard](../../assets/applications.png)
+![Coder Dashboard](../../assets/guides/deployments/applications.png)
 
 ## Developer workflows
 
@@ -26,15 +26,15 @@ addition to the base code-server functionality.
 - [Manage workspaces with the Coder CLI](https://coder.com/docs/cli)
 - [Personalize workspaces](https://coder.com/docs/workspaces/personalization)
 
-![User management icon](../../assets/manage-users.png)
+![User management icon](../../assets/guides/deployments/manage-users.png)
 
 ## Team management
 
 - [Implement single-sign-on](https://coder.com/docs/admin/access-control#openid-connect)
 - [Assign user roles](https://coder.com/docs/admin/access-control/user-roles)
 - [Manage organizations](https://coder.com/docs/admin/access-control/organizations)
 
-![Workspace providers](../../assets/workspace-providers-admin.png)
+![Workspace providers](../../assets/admin/workspace-providers-admin.png)
 
 ## Operations