Merge branch 'bpmct/docs' of https://github.com/coder/coder into bpmct/docs

Katie Horne · Katie Horne · commit c875319899e7 · 2022-04-26T08:15:15.000-05:00
diff --git a/docs/README.md b/docs/README.md
@@ -18,8 +18,8 @@ Provision remote development environments with Terraform.
 
 ## Installing Coder
 
-Install [the latest release](https://github.com/coder/coder/releases) on a
-system with at least 2 CPU cores and 2 GB RAM.
+Install [the latest release](https://github.com/coder/coder/releases) on a system with
+at least 1 CPU core and 2 GB RAM.
 
 To test, start with dev mode (all data is in-memory and is destroyed on exit):
 
@@ -95,4 +95,3 @@ coder templates update gcp-linux
 ## Contributing
 
 Read the [contributing docs](./CONTRIBUTING.md).
-
diff --git a/docs/about.md b/docs/about.md
@@ -52,9 +52,9 @@ Azure, Google Cloud, Kubernetes, and more.
 
 ## What Coder is *not*
 
-- Coder is an infrastructure-as-code (IaC) platform. Terraform is the first IaC
-  *provisioner* in Coder. As a result, Coder admins can define Terraform
-  resources as Coder workspaces.
+- Coder is not an infrastructure as code (IaC) platform. Terraform is the first
+  IaC *provisioner* in Coder, allowing Coder admins to define Terraform
+ resources as Coder workspaces.
 
 - Coder is not a DevOps/CI platform. Coder workspaces can follow best practices
   for cloud service-based workloads, but Coder is not responsible for how you
diff --git a/docs/templates.md b/docs/templates.md
@@ -39,17 +39,17 @@ template:
 | └─ nodejs (linux, amd64)     |            |
 | api_token.backend            | ephemeral  |
 
-When a workspace is deleted, all related resources are destroyed.
+When a workspace is deleted, all resources are destroyed.
 
-## Variables
+## Parameters
 
-Templates often contain *variables*. In Coder, there are two types of variables:
+Templates often contain *parameters*. In Coder, there are two types of parameters:
 
-- **Admin variables** are set when a template is created/updated. These values
+- **Admin parameters** are set when a template is created/updated. These values
   are often cloud secrets, such as a `ServiceAccount` token, and are annotated
   with `sensitive =  true` in the template code.
 
-**User variables** are set when a user creates a workspace. They are unique to
+**User parameters** are set when a user creates a workspace. They are unique to
 each workspace, and they are often personalization settings such as preferred
 region or workspace image.
 
