feat: add comparison to docs (#1315)

bpmct · khorne3 · web-flow · commit e8e4cf9a375d · 2022-05-10T16:31:59.000Z
* fix typo

* feat: add comparison table

* Update docs/about.md

Co-authored-by: Katie Horne &lt;katie@23spoons.com&gt;

* Update docs/about.md

Co-authored-by: Katie Horne &lt;katie@23spoons.com&gt;

* Update docs/about.md

Co-authored-by: Katie Horne &lt;katie@23spoons.com&gt;

* chore: remove gitpod

Co-authored-by: Katie Horne &lt;katie@23spoons.com&gt;
diff --git a/docs/README.md b/docs/README.md
@@ -82,11 +82,12 @@ coder templates update gcp-linux
   - [Why remote development](about.md#why-remote-development)
   - [Why Coder](about.md#why-coder)
   - [What Coder is not](about.md#what-coder-is-not)
+  - [Comparison: Coder vs. [product]](about.md#comparison)
 - [Templates](./templates.md)
   - [Manage templates](./templates.md#manage-templates)
   - [Persistent and ephemeral
     resources](./templates.md#persistent-and-ephemeral-resources)
-  - [Variables](./templates.md#variables)
+  - [Parameters](./templates.md#parameters)
 - [Workspaces](./workspaces.md)
   - [Create workspaces](./workspaces.md#create-workspaces)
   - [Connect with SSH](./workspaces.md#connect-with-ssh)
@@ -102,6 +103,7 @@ Read the [contributing docs](./CONTRIBUTING.md).
 
 <!--- Add your row by date (mm/dd/yyyy), most recent date at end of list --->
 
+
 | Name                | Start Date | First PR Date |           Organization            |                            GitHub User Link |
 | ------------------- | :--------: | :-----------: | :-------------------------------: | ------------------------------------------: |
 | Mathias Fredriksson | 04/25/2022 |  04/25/2022   | [Coder](https://github.com/coder) |     [mafredri](https://github.com/mafredri) |
diff --git a/docs/about.md b/docs/about.md
@@ -70,6 +70,18 @@ Azure, Google Cloud, Kubernetes, and more.
 - Coder is not a SaaS/fully-managed offering. You must host
   Coder on a cloud service (AWS, Azure, GCP) or your private data center.
 
+## Comparison
+
+Please file [an issue](https://github.com/coder/coder/issues/new) if any information is out of date. Also refer to: [What Coder is not](./about.md#what-coder-is-not).
+
+
+| Tool                                                        | Type                                    | Self-hosted version          | Hosted version | Availability                    | Supported platforms                                                                                                                                        |
+| :---------------------------------------------------------- | :-------------------------------------- | :--------------------------- | :------------- | :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Coder](https://github.com/coder/coder)                     | Platform: multiple workspaces and teams | ✅                            |                | Open source (paid version soon) | All [Terraform](https://www.terraform.io/registry/providers) resources, all clouds, multi-architecture: Linux, Mac, Windows, containers, VMs, amd64, arm64 |
+| [Coder (Classic)](https://coder.com/docs)                   | Platform: multiple workspaces and teams | ✅                            |                | Proprietary/paid license        | Any Kubernetes cluster: Linux Containers                                                                                                                   |
+| [GitHub Codespaces](https://github.com/features/codespaces) | Platform: solo or team                  | Only GitHub Enterprise Cloud | ✅              | Open source/paid                | Linux containers                                                                                                                                           |
+| [code-server](https://github.com/cdr/code-server)           | Web IDE: solo developer                 | ✅                            |                | Open source                     | Linux, Mac, Windows, containers, VMs, amd64, arm64                                                                                                         |
+
 ---
 
 Next: [Templates](./templates.md)
