docs: revert 14744 without removing files

docs/README.md

@@ -143,4 +143,4 @@ or [the v2 migration guide and FAQ](https://coder.com/docs/v1/guides/v2-faq).
 
 - Learn about [Templates](./admin/templates/index.md)
 - [Install Coder](./install/index.md)
-- Follow the [Quickstart guide](./tutorials/quickstart.md) to try Coder out for yourself.
+- Follow the [Quickstart guide](./start/coder-tour.md) to try Coder out for yourself.

docs/admin/templates/managing-templates/index.md

@@ -1,8 +1,8 @@
 # Working with templates
 
-You create and edit Coder templates as
-[Terraform](../../../tutorials/quickstart.md) configuration files (`.tf`) and
-any supporting files, like a README or configuration files for other services.
+You create and edit Coder templates as [Terraform](../../../start/coder-tour.md)
+configuration files (`.tf`) and any supporting files, like a README or
+configuration files for other services.
 
 ## Who creates templates?
 

docs/install/index.md

@@ -64,5 +64,5 @@ coder login https://coder.example.com
 
 ## Next steps
 
-- [Set up your first deployment](../tutorials/quickstart.md)
+- [Set up your first deployment](../start/coder-tour.md)
 - [Expose your control plane to other users](../admin/setup/index.md)

docs/manifest.json

@@ -10,7 +10,7 @@
 				{
 					"title": "Coder quickstart",
 					"description": "Try it out for yourself",
-					"path": "./tutorials/quickstart.md"
+					"path": "./start/coder-tour.md"
 				},
 				{
 					"title": "Screenshots",
@@ -637,7 +637,7 @@
 				{
 					"title": "Get started with Coder",
 					"description": "Learn how to install and run Coder quickly",
-					"path": "./tutorials/quickstart.md"
+					"path": "./start/coder-tour.md"
 				},
 				{
 					"title": "Write a Template from Scratch",

docs/start/coder-tour.md

@@ -0,0 +1,187 @@
+## Tour Coder and Set up your first deployment.
+
+For day-zero Coder users, we recommend following this guide to set up a local
+Coder deployment, create your first template, and connect to a workspace. This
+is completely free and leverages our
+[open source repository](https://github.com/coder/coder).
+
+We'll use [Docker](https://docs.docker.com/engine) to manage the compute for a
+slim deployment to experiment with [workspaces](../user-guides/index.md) and
+[templates](../admin/templates/index.md).
+
+Docker is not necessary for every Coder deployment and is only used here for
+simplicity.
+
+# Set up your Coder Deployment
+
+## 1. Install Docker
+
+First, install [Docker](https://docs.docker.com/engine/install/) locally.
+
+> If you already have the Coder binary installed, restart it after installing
+> Docker.
+
+## 2. Install Coder daemon
+
+<div class="tabs">
+
+## Linux/macOS
+
+Our install script is the fastest way to install Coder on Linux/macOS:
+
+```sh
+curl -L https://coder.com/install.sh | sh
+```
+
+## Windows
+
+> **Important:** If you plan to use the built-in PostgreSQL database, you will
+> need to ensure that the
+> [Visual C++ Runtime](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist#latest-microsoft-visual-c-redistributable-version)
+> is installed.
+
+You can use the
+[`winget`](https://learn.microsoft.com/en-us/windows/package-manager/winget/#use-winget)
+package manager to install Coder:
+
+```powershell
+winget install Coder.Coder
+```
+
+</div>
+
+## 3. Start the server
+
+To start or restart the Coder deployment, use the following command:
+
+```shell
+coder server
+```
+
+The output will provide you with a URL to access your deployment, where you'll
+create your first administrator account.
+
+![Coder login screen](../images/start/setup-page.png)
+
+Once you've signed in, you'll be brought to an empty workspaces page, which
+we'll soon populate with your first development environments.
+
+### More information on the Coder Server
+
+# Create your first template
+
+A common way to create a template is to begin with a starter template then
+modify it for your needs. Coder makes this easy with starter templates for
+popular development targets like Docker, Kubernetes, Azure, and so on. Once your
+template is up and running, you can edit it in the Coder dashboard. Coder even
+handles versioning for you so you can publish official updates or revert to
+previous versions.
+
+In this tutorial, you'll create your first template from the Docker starter
+template.
+
+## 1. Choose a starter template
+
+Select **Templates** to see the **Starter Templates**. Use the **Docker
+Containers** template by pressing **Use Template**.
+
+![Starter Templates UI](../images/start/starter-templates-annotated.png)
+
+> You can also a find a comprehensive list of starter templates in **Templates**
+> -> **Create Template** -> **Starter Templates**.
+
+## 2. Create your template
+
+In **Create template**, fill in **Name** and **Display name**, then select
+**Create template**.
+
+![Creating a template](../images/start/create-template.png)
+
+TODO:
+
+- add CLI guide for making a new template
+- refactor text below to be more beginner-friendly
+
+# Create a workspace
+
+## 1. Create a workspace from your template
+
+When the template is ready, select **Create Workspace**.
+
+![Template Preview](../images/start/template-preview.png)
+
+In **New workspace**, fill in **Name** then scroll down to select **Create
+Workspace**.
+
+![Create Workspace](../images/start/create-workspace.png)
+
+Coder starts your new workspace from your template.
+
+After a few seconds, your workspace is ready to use.
+
+![Workspace is ready](../images/start/workspace-ready.png)
+
+## 4. Try out your new workspace
+
+This starter template lets you connect to your workspace in a few ways:
+
+- VS Code Desktop: Loads your workspace into
+  [VS Code Desktop](https://code.visualstudio.com/Download) installed on your
+  local computer.
+- code-server: Opens
+  [browser-based VS Code](../user-guides/workspace-access/vscode.md) with your
+  workspace.
+- Terminal: Opens a browser-based terminal with a shell in the workspace's
+  Docker instance.
+- SSH: Use SSH to log in to the workspace from your local machine. If you
+  haven't already, you'll have to install Coder on your local machine to
+  configure your SSH client.
+
+> **Tip**: You can edit the template to let developers connect to a workspace in
+> [a few more ways](../admin/templates/managing-templates/devcontainers.md).
+
+When you're done, you can stop the workspace.
+
+## 6. Modify your template
+
+Now you can modify your template to suit your team's needs.
+
+Let's replace the `golang` package in the Docker image with the `python3`
+package. You can do this by editing the template's `Dockerfile` directly in your
+web browser.
+
+In the Coder dashboard, select **Templates** then your first template.
+
+![Selecting the first template](../images/templates/select-template.png)
+
+In the drop-down menu, select **Edit files**.
+
+![Edit template files](../images/templates/edit-files.png)
+
+Expand the **build** directory and select **Dockerfile**.
+
+![Selecting source code](../images/templates/source-code.png)
+
+Edit `build/Dockerfile` to replace `golang` with `python3`.
+
+![Editing source code](../images/templates/edit-source-code.png)
+
+Select **Build template** and wait for Coder to prepare the template for
+workspaces.
+
+![Building a template](../images/templates/build-template.png)
+
+Select **Publish version**. In the **Publish new version** dialog, make sure
+**Promote to default version** is checked then select **Publish**.
+
+![Publish a template](../images/templates/publish.png)
+
+Now when developers create a new workspace from this template, they can use
+Python 3 instead of Go.
+
+For developers with workspaces that were created with a previous version of your
+template, Coder will notify them that there's a new version of the template.
+
+You can also handle
+[change management](../admin/templates/managing-templates/change-management.md)
+through your own repo and continuous integration.