chore: minor clarifications to install docs (#3983)

bpmct · web-flow · commit e5e1ed2f9c08 · 2022-09-12T10:50:20.000+10:00
diff --git a/docs/install/index.md b/docs/install/index.md
@@ -1,4 +1,4 @@
-There are a number of different methods to install Coder:
+There are a number of different methods to install and run Coder:
 
 <children>
   This page is rendered on https://coder.com/docs/coder-oss/install. Refer to the other documents in the `install/` directory for per-platform instructions.
diff --git a/docs/install/kubernetes.md b/docs/install/kubernetes.md
@@ -1,8 +1,9 @@
 ## Requirements
 
-Before proceeding, please ensure that you have both Helm 3.5+ and the
-[latest version of Coder](https://github.com/coder/coder/releases) installed.
-You will also need to have a Kubernetes cluster running K8s 1.19+.
+Before proceeding, please ensure that you have a Kubernetes cluster running K8s 1.19+ and have Helm 3.5+ installed.
+
+You'll also want to install the [latest version of Coder](https://github.com/coder/coder/releases) locally in order
+to log in and manage templates.
 
 ## Install Coder with Helm
 
diff --git a/docs/install/packages.md b/docs/install/packages.md
@@ -1,31 +1,31 @@
-Coder publishes the following system packages [in GitHub releases](https://github.com/coder/coder/releases):
+1. Download and install one of the following system packages from [GitHub releases](https://github.com/coder/coder/releases):
 
-- .deb (Debian, Ubuntu)
-- .rpm (Fedora, CentOS, RHEL, SUSE)
-- .apk (Alpine)
+   - .deb (Debian, Ubuntu)
+   - .rpm (Fedora, CentOS, RHEL, SUSE)
+   - .apk (Alpine)
 
-Once installed, you can run Coder as a system service.
+1. Run Coder as a system service.
 
-```sh
-# Set up an access URL or enable CODER_TUNNEL
-sudo vim /etc/coder.d/coder.env
+   ```sh
+   # Set up an access URL or enable CODER_TUNNEL
+   sudo vim /etc/coder.d/coder.env
 
-# To systemd to start Coder now and on reboot
-sudo systemctl enable --now coder
+   # To systemd to start Coder now and on reboot
+   sudo systemctl enable --now coder
 
-# View the logs to see Coder's URL and ensure a successful start
-journalctl -u coder.service -b
-```
+   # View the logs to see Coder's URL and ensure a successful start
+   journalctl -u coder.service -b
+   ```
 
-> Set `CODER_ACCESS_URL` to the external URL that users and workspaces will use to
-> connect to Coder. This is not required if you are using the tunnel. Learn more
-> about Coder's [configuration options](../admin/configure.md).
+   > Set `CODER_ACCESS_URL` to the external URL that users and workspaces will use to
+   > connect to Coder. This is not required if you are using the tunnel. Learn more
+   > about Coder's [configuration options](../admin/configure.md).
 
-Visit the Coder URL in the logs to set up your first account, or use the CLI:
+1. Visit the Coder URL in the logs to set up your first account, or use the CLI:
 
-```sh
-coder login <access-url>
-```
+   ```sh
+   coder login <access-url>
+   ```
 
 ## Restarting Coder
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-There are a number of different methods to install Coder:`
	`1`	`+There are a number of different methods to install and run Coder:`
`2`	`2`
`3`	`3`	`<children>`
`4`	`4`	This page is rendered on https://coder.com/docs/coder-oss/install. Refer to the other documents in the `install/` directory for per-platform instructions.