coder · khorne3 · Jan 10, 2022 · Jan 6, 2022 · Jan 7, 2022 · Jan 10, 2022
diff --git a/getting-started/admin.md b/getting-started/admin.md
@@ -0,0 +1,94 @@
+---
+title: Administrators
+description: Getting started with Coder as an administrator.
+---
+
+This article will walk you through the steps needed to set up, deploy, and
+configure Coder so that your developers are ready create their workspaces and
+begin working on their projects.
+
+## Set up and deploy Coder
+
+To get started with Coder, you will need to:
+
+1. [Create a Kubernetes cluster](../setup/kubernetes/index.md)
+
+1. [Install Coder via Helm](../setup/installation.md)
+
+Alternatively, [Coder for Docker](../setup/docker.md) allows you to deploy Coder
+quickly to machines where you have Docker installed. We recommend this option
+for teams with 5-10 developers.
+
+## Configure Coder
+
+Once you've deployed Coder, you'll need to log in and perform the following
+configuration steps:
+
+1. [Upload your license file](../setup/configuration.md) (you can get a trial
+   license for free [here](https://coder.com/trial))
+
+1. Set up [access controls](../admin/access-control/index.md) with OpenID
+   Connect (OIDC) if you'd like to allow users to register themselves
+
+1. [Create organizations](../admin/organizations/index.md) to manage your user
+   groups
+
+1. Create an OAuth app for your users to
+   [connect to your Git provider](../admin/git.md)
+
+1. [Add a container registry](../admin/registries/index.md) for your development
+   environments to pull from
+
+1. [Import an image](../images/importing.md) with the tools your developers
+   need. You can [create custom images](../images/writing.md) for your developer
+   workspaces as well.
+
+## Provision users
+
+To allow developers to access your Coder deployment, you can manually create and
+invite users, or you can set up OpenID Connect (OIDC):
+
+- [Azure AD](../guides/admin/oidc-azuread.md)
+- [Okta](../guides/admin/oidc-okta.md)
+
+If you are using another Identity Provider (IdP), the process should be very
+similar.
+
+With OIDC configured, Coder will automatically create a user and add them to the
+[default organization](../admin/organizations/index.md) when a developer logs in
+for the first time.
+
+## Automate
+
+You can use the Coder [command-line (CLI) tool](../cli/index.md) to interact
+with Coder, as well as the [public API](../guides/api.md) to automate various
+tasks through code.
+
+## Maintain and upgrade
+
+Coder releases [upgrades](../setup/upgrade/index.md) on the third Wednesday of
+each month, with patch releases published and available as needed.
+
+Coder maintains a public [changelog](../changelog/index.md) and
+[release calendar](https://coder.com/release-calendar.ical) to keep you updated
+on features, bug fixes, security updates, and breaking changes that are coming.
+
+## Interact with Support
+
+Coder’s standard support is included with your license. You can reach us at
+[support@coder.com](mailto:support@coder.com), and one of our engineers will be
+able to assist. Please include any relevant logs, error messages, or
+screenshots.
+
+Coder also has a [public community Slack](https://cdr.co/join-community) you can
+join if you’d like.
+
+Finally, Coder offers premium support through Coder Escalation Services, which
+provides a faster response Service-Level Agreement (SLA). Speak to your account
+executive if you’re interested in this option.
+
+## Additional information
+
+We encourage you to look through the various [Guides](../guides/index.md) in our
+public documentation, as it contains more detailed information on specific use
+cases and topics.
diff --git a/getting-started/index.md b/getting-started/index.md
@@ -11,103 +11,15 @@ icon:
 ---
 
 We’re excited for you to be part of the growing community of Coder users, and we
-wanted to provide an onboarding guide to ensure you have a great experience.
-Coder’s [documentation is publicly editable](https://github.com/cdr/docs), so
-please feel free to contribute and provide feedback as you desire.
-
-If you're participating in our hosted beta, please see our
-[guide on getting started](guides/hosted-beta/index.md). If you're deploying
-Coder to your own clusters, please proceed with this article.
-
-## Set up and deploy Coder
-
-To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) to a
-Kubernetes cluster. We have documentation to help you
-[create a cluster](./setup/kubernetes/index.md) if needed. Once you have a
-cluster, you can [install Coder via Helm](./setup/installation.md).
-
-## Configure Coder
-
-After you deploy Coder, you’ll need to
-[upload your license file](./setup/configuration.md) before you can configure
-the application (you can get a trial license for free
-[here](https://coder.com/trial)). Once logged in, you’ll be able to access the
-[administration management](./admin/index.md) menu to set up things such as
-[access controls](./admin/access-control/index.md) with OpenID Connect (OIDC),
-[create organizations](./admin/organizations/index.md), and create an OAuth app
-for your users to [connect to your Git provider](./admin/git.md).
-
-At a minimum, you’ll want to ensure you
-[add a container registry](./admin/registries/index.md) for your development
-environments to pull from, and [import an image](./images/importing.md) with the
-tools your developers need. You can [create custom images](./images/writing.md)
-for your developer workspaces as well.
-
-## Provision users
-
-With some base configuration done, you’ll want to allow your developers to begin
-using Coder. You can manually create and invite users, or you can set up OpenID
-Connect (OIDC) with [Azure AD](./guides/admin/oidc-azuread.md) or
-[Okta](./guides/admin/oidc-okta.md). If you are using another Identity Provider
-(IdP), the process should be very similar. With OIDC configured, Coder will
-automatically create a user and add them to the
-[default organization](./admin/organizations/index.md) when a developer logs in
-for the first time.
-
-## Automate
-
-Coder has a [command-line (CLI) tool](./cli/index.md) that you and your
-developers may be interested in using to interact with Coder. The CLI is
-completely [open-sourced](https://github.com/cdr/coder-cli), and we always
-welcome contributions. Additionally, Coder has a [public API](./guides/api.md)
-that you can use to automate various tasks through code.
-
-## Connect local IDEs
-
-While Coder supports a
-[variety of IDEs in the browser](https://coder.com/docs/coder/v1.20/workspaces/editors),
-such as VSCode and the JetBrains product suite, some developers may want to use
-their local installation of these tools or other IDEs with Coder. By leveraging
-the [Coder CLI](./cli/index.md), developers will be able to
-[connect their terminal](./cli/remote-terminal.md) to the remote environment’s
-terminal, and enable [file sync](./cli/file-sync.md) to have their local
-directory’s tree sync with the remote file system.
-
-## Maintain and update
-
-Coder maintains a public [changelog](./changelog/index.md) and
-[release calendar](https://coder.com/release-calendar.ical) to help you stay in
-the know on features, bug fixes, security updates, and breaking changes that are
-coming. Coder releases are available on the third Wednesday of each month, and
-patch releases are published and available as needed.
-
-## Interact with Support
-
-Coder’s standard support is included with your license. You can reach us at
-[support@coder.com](mailto:support@coder.com), and one of our engineers will be
-able to assist. Please include any relevant logs, error messages, or
-screenshots.
-
-Coder also has a [public community Slack](https://cdr.co/join-community) you can
-join if you’d like.
-
-Finally, Coder offers premium support through Coder Escalation Services, which
-provides a faster response Service-Level Agreement (SLA). Speak to your account
-executive if you’re interested in this option.
-
-## Additional information
-
-There are a variety of ways to follow Coder to stay up-to-date on company
-updates, whitepapers, blog posts, and more.
-
-- [Coder Blog](https://coder.com/blog)
-- [Videos about Coder](https://coder.com/resources/videos)
-- [Whitepapers](https://coder.com/resources/whitepapers)
-- Social media accounts such as
-  [LinkedIn](https://www.linkedin.com/company/coderhq),
-  [YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw),
-  [Twitter](https://twitter.com/coderhq), and others
-
-Finally, we encourage you to look through the various
-[Guides](./guides/index.md) in our public documentation, as it contains more
-detailed information on specific use cases and topics.
+wanted to provide this onboarding guide to help you get started.
+
+If you've been tasked with deploying and configuring Coder, please see our
+[admin](admin.md) guide for a high-level overview of what you need to do so that
+your developers can create their workspaces and begin working on their projects.
+
+There are two primary ways of deploying Coder, and we offer developer-oriented
+guides for both [Kubernetes deployments](developers.md) and
+[deployments using Coder for Docker](docker.md). Once developers have a Coder
+deployment available to them, these end-to-end guides will walk them through
+logging in and getting set up with a sample project they can use to experience
+Coder.
diff --git a/index.md b/index.md
@@ -20,7 +20,7 @@ enterprise security.
     Welcome to your new computer in the cloud.
   </p>
 
-  <a href="./workspaces/getting-started.md">
+  <a href="./getting-started/index.md">
     <button class="arrow">
       Get started
     </button>

diff --git a/manifest.json b/manifest.json
@@ -29,6 +29,9 @@
     {
       "path": "getting-started/index.md",
       "children": [
+        {
+          "path": "getting-started/admin.md"
+        },
         {
           "path": "getting-started/developers.md"
         },