Update index.mdx with markdown

Author: anorrish

docs/admin/deploy/index.mdx

@@ -1,41 +1,71 @@
-Deployment Overview
+# Deployment Overview
+
 Sourcegraph is a powerful code intelligence platform that can be deployed in various ways to suit your organization's needs. This guide will help you understand the available deployment options and choose the best one for your use case.
 
-Deployment types
+## Deployment types
+
 Carefully consider your organization's needs and technical expertise when selecting a Sourcegraph deployment method. Each option has different capabilities, resource requirements, and levels of technical expertise needed. Consider your organization's needs carefully, as the deployment method cannot be easily changed for a running instance.
 
 Sourcegraph's recommended deployment methods are, in order:
+1. [Sourcegraph Cloud](#sourcegraph-cloud) - This povides a fully managed solution where Sourcegraph handles much of the maintence, monitoring, and upgrading tasks to give you an optimal Sourcegraph experience while immediately getting the latest features into your users' hands. This solution does require your code hosts to be connected to the Sourcegraph managed environment.
+2. [Kubernetes Helm](#kubernetes) - Sourcegraph's Kubernetes deployment provides the most robust, scalable, and vetted self-hosted solution. This solution is ideal across many self-hosted customers capable of deploying a mult-node instance, and can be supported within many Kubernetes-capable environments.
+3. [Docker Compose](#docker-compose) - Docker Compose provides the prefered single-node deployment solution for Sourcegraph. It can be a good option when the complexities and flexibility provided by Kubernetes Helm are not needed.
+4. [Kubernetes Kustomize](#kubernetes) - Kustomize should only be used in place of Helm in specific circumstances. Kustomize tends to be a more advanced solution than Helm, but if it is your prefered deployment method it is a viable and supported method.
+5. [Machine Images](#machine-images) - Sourcegraph can be deployed used dedicated Machine Images for specific Cloud providers. This can be a simple solution in specific circumstances, though has its own considerations. If you are considering this path, please discuss with your account team.
+
+### Sourcegraph Cloud
+
+Best for a wide range of customers open to a Sourcegraph managed [Sourcegraph Cloud](https://about.sourcegraph.com/get-started?t=enterprise) solution. Sourcegraph Cloud is hosted and maintained by Sourcegraph.
 
-Sourcegraph Cloud - This povides a fully managed solution where Sourcegraph handles much of the maintence, monitoring, and upgrading tasks to give you an optimal Sourcegraph experience while immediately getting the latest features into your users' hands. This solution does require your code hosts to be connected to the Sourcegraph managed environment.
-Kubernetes Helm - Sourcegraph's Kubernetes deployment provides the most robust, scalable, and vetted self-hosted solution. This solution is ideal across many self-hosted customers capable of deploying a mult-node instance, and can be supported within many Kubernetes-capable environments. This is typically the preferred method for self-hosting Sourcegraph.
-Docker Compose - Docker Compose provides the prefered single-node deployment solution for Sourcegraph. It can be a good option when the complexities and flexibility provided by Kubernetes Helm are not needed.
-Kubernetes Kustomize - Kustomize should only be used in place of Helm in specific circumstances. Kustomize tends to be a more advanced solution than Helm, but if it is your prefered deployment method it is a viable and supported method.
-Machine Images - Sourcegraph can be deployed used dedicated Machine Images for specific Cloud providers. This can be a simple solution in specific circumstances, though has its own considerations. If you are considering this path, please discuss with your account team.
-Sourcegraph Cloud
-Best for a wide range of customers open to a Sourcegraph managed Sourcegraph Cloud solution. Sourcegraph Cloud is hosted and maintained by Sourcegraph.
+<LinkCards>
+
+  <LinkCard href="https://about.sourcegraph.com/get-started?t=enterprise" imgSrc="https://sourcegraph.com/.assets/img/sourcegraph-mark.svg" imgAlt="Sourcegraph" title="Get a single-tenant instance managed by Sourcegraph." description="Sign up and get a 30 day free trial for your team." />
+
+</LinkCards>
+
+### Kubernetes
 
-Kubernetes
 Multi-node, self hosted solution great for large enterprises and or other orgs looking for the recommended, robust, and scalable deployment method
 
-Helm <Prefered> utilizes pre-packaged charts for templating Sourcegraph deployments
-Kustomize utilizes built-in features of kubectl for configuring Sourcegraph deployments
-Kubernetes is the recommended self hosted deployment method, though it can require specific technical knowledge required to deploy and maintain a deployment on Kubernetes. Teams without these resources should contact their Sourcegraph account representative or [email protected] to discuss in further detail.
+- **Helm** <<e>Prefered</e>> utilizes pre-packaged charts for templating Sourcegraph deployments
+- **Kustomize** utilizes built-in features of kubectl for configuring Sourcegraph deployments
+
+<QuickLinks>
+    <QuickLink title="Helm" icon='theming' href="/admin/deploy/kubernetes" />
+    <QuickLink title="Kustomize" icon='lightbulb' href="/admin/deploy/kubernetes/kustomize" />
+</QuickLinks>
 
-Docker Compose
-Single-node, self hosted solution for enterprises looking for a single-node, non-Kubernetes solution. Sourcegraph can be supported at a large variety of scales on Docker Compose, though the flexibility and robustness is less than that of a Kubernetes deployment.
+<Callout type="note">Kubernetes is the recommended self hosted deployment method, though it can require specific technical knowledge required to deploy and maintain a deployment on Kubernetes. Teams without these resources should contact their Sourcegraph account representative or [[email protected]](mailto:[email protected]) to discuss in further detail.</Callout>
+
+### Docker Compose
+
+Single-node, self hosted solution for enterprises looking for a simpler, non-Kubernetes solution. Docker Compose can support Sourcegraph at a large range of scales, though this deployment solution tends to be less flexible and robust in comparison to our Kubernetes solution.
+
+<QuickLinks>
+  <QuickLink title="Docker Compose" icon='installation' href="/admin/deploy/docker-compose" />
+</QuickLinks>
+
+### Machine Images
 
-Machine Images
 Best for enterprises looking for a self-hosted solution on the Cloud provider of their choice.
 
 Customized machine images allow you to spin up a preconfigured Sourcegraph instance with just a few clicks, all in less than 10 minutes. Currently available in the following hosts:
 
-See Sourcegraph Machine Images for more information.
+<QuickLinks>
+  <QuickLink title="Amazon Machine Image (AMI)" icon='lightbulb' href="/admin/deploy/machine-images/aws-ami" />
+  <QuickLink title="Google Compute Image" icon='presets' href="/admin/deploy/machine-images/gce" />
+</QuickLinks>
+
+See [Sourcegraph Machine Images](/admin/deploy/machine-images) for more information.
+
+<Callout type="note">Deploying with machine images requires technical expertise and the ability to maintain and manage your own infrastructure.</Callout>
+
+### On-premises
+
+For setting up quick **non-production** environments on-premises.
 
-Deploying with machine images requires technical expertise and the ability to maintain and manage your own infrastructure.
+  - [Docker Single Container](/admin/deploy/docker-single-container/) - Install Sourcegraph using a single Docker container
 
-On-premises
-For setting up quick non-production environments on-premises.
+### ARM / ARM64 support
 
-Docker Single Container - Install Sourcegraph using a single Docker container
-ARM / ARM64 support
 Running Sourcegraph on ARM / ARM64 images is not supported for production deployments at this time.