Merge branch 'main' of github.com:letsdiscodev/docs.letsdisco.dev

Author: gregsadetsky

docs/exhaustive-documentation/ports.md

@@ -72,7 +72,7 @@ All ports are exposed in this private network. For example, we could have an int
 
 `web` could also expose other ports to be made available internally without exposing them to the internet. Only the port of `web` that is defined in `port` is exposed to the internet (defaulting to `8000` when none is specified).
 
-## Publishing Ports Extenally
+## Publishing Ports Externally
 
 In the case where you would like to expose a port externally, bypassing the reverse proxy, you can it like so:
 

docs/get-started/install-the-cli.md

@@ -6,13 +6,15 @@ sidebar_position: 1
 
 ### Easy install
 
+The CLI is meant to be installed on your own, local development machine. You don't need to install it on any of your servers.
+
 The easiest way to set up the CLI under Linux and macOS is to run:
 
 ```bash
 curl https://cli-assets.letsdisco.dev/install.sh | sh
 ```
 
-The installation script above requires sudo.
+The installation script above requires sudo to create symbolic links under `/usr/local`. 
 
 ---
 

docs/get-started/set-up-your-server.md

@@ -12,18 +12,20 @@ You will also need a dedicated domain name for the server itself (in addition to
 
 ## Step One: disco init
 
-First, you need to install disco on your server. For this, you run `disco init` and you pass it the SSH `user@DOMAIN` to use for disco.
+Once you've installed the CLI on your local development machine, we will initialize your server. For this, you run `disco init` on your computer and pass it the ssh `USER@DOMAIN` combination that the CLI will use to connect to your server.
+
+**NOTE**: you need to run this command on *your* computer, not on your server. ie, install the `disco` CLI and run all of the commands below on your development machine.
+
+For example, if the user is `root` and the domain is `disco.example.com`:
 
-For example, if the user is `root` and the domain is `disco.example.com`
 ```bash
 disco init [email protected]
 ```
 
 ## Step Two: Add the Github app
 
-Once disco is installed, it will need to be connected to Github.
+Once disco is installed, it will need to be connected to Github. Run:
 
-Run
 ```bash
 disco github:apps:add
 ```