add more troubleshooting to the readme

Author: wagslane

README.md

@@ -10,23 +10,31 @@ The official command line tool for [Boot.dev](https://www.boot.dev). It allows y
 
 ## Installation
 
-### 1. You need Go 1.22 installed
+### 1. Install Go 1.22 or later
 
-The Boot.dev CLI only works on Linux and Mac. If you're on Windows, you'll need to use WSL. Make sure you install go in your Linux/WSL terminal, not your Windows terminal/UI. You can use the [webi instructions here](https://webinstall.dev/golang/) for a quick and easy Go installation on the command line. To do so, run this in your terminal:
+The Boot.dev CLI requires a Golang installation, and only works on Linux and Mac. If you're on Windows, you'll need to use WSL. Make sure you install go in your Linux/WSL terminal, not your Windows terminal/UI. There are two options:
+
+**Option 1**: [The webi installer](https://webinstall.dev/golang/) is the simplest way for most people. Just run this in your terminal:
 
 ```bash
 curl -sS https://webi.sh/golang | sh
 ```
 
-*Be sure to read the output of the command and follow any instructions. You might need to update your PATH.*
+_read the output of the command and follow any instructions. You might need to update your PATH._
 
-Alternatively, you can use the [official installation instructions](https://go.dev/doc/install).
+**Option 2**: Use the [official installation instructions](https://go.dev/doc/install).
 
 Run `go version` on your command line to make sure the installation worked.
 
+**Troubleshooting:**
+
+- If you already had Go installed with webi, you should be able to run the same webi command to update it.
+- If you already had a version of Go installed a different way, you can use `which go` to find out where it is installed, and remove the old version manually.
+- Check the "troubleshooting command not found" section below if that's the error you're getting.
+
 ### 2. Install the Boot.dev CLI
 
-This command will download, build, and install the `bootdev` command into your Go toolchain's `bin` directory. Go ahread and run it:
+This command will download, build, and install the `bootdev` command into your Go toolchain's `bin` directory. Go ahead and run it:
 
 ```bash
 go install github.com/bootdotdev/bootdev@latest
@@ -38,34 +46,56 @@ Make sure that it works by running:
 bootdev help
 ```
 
-### 3. Add to PATH (if you're having issues)
+If you're having issues, check the "troubleshooting command not found" section below.
 
-If you're getting a "command not found" error, it's most likely because Go's bin directory (where your `bootdev` command is) isn't in your PATH. You can add the bin directory to your PATH by modifying your shell's configuration file. For example, if you're using bash on Ubuntu (e.g. WSL), you can run the following commands to add a line to your `~/.bashrc` file:
+### 3. Login to the CLI
 
-```bash
-echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.bashrc
+Run `bootdev login` to authenticate with your Boot.dev account. After authenticating, you're ready to go!
+
+### Troubleshooting "command not found"
+
+If you're getting a "command not found" error for either the `go version` or the `bootdev help`, it's most likely because the directory containing the `go` binary isn't in your [`PATH`](https://opensource.com/article/17/6/set-path-linux). You can add the bin directory to your `PATH` by modifying your shell's configuration file. _Also, be sure to read the output of any installation commands you run, as they likely contain important info._
 
+**PATH issues with Go itself**:
+
+You need to know _where_ the `go` command was installed. It might be in:
+
+- `~/.local/opt/go/bin` (webi)
+- `/usr/local/go/bin` (official installation)
+- somewhere else?
+
+You should be able to ensure it exists by attempting to run `go` with the full filepath. For example, if you think it's in `~/.local/opt/go/bin`, you can run `~/.local/opt/go/bin/go version`. If that works, then you just need to add `~/.local/opt/go/bin` to your `PATH` and reload your shell:
+
+```bash
+# For Linux/WSL
+echo 'export PATH=$PATH:$HOME/.local/opt/go/bin' >> ~/.bashrc
 # next, reload your shell configuration
 source ~/.bashrc
 ```
 
-Or if you're on Mac OS using zsh:
-
 ```bash
-echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.zshrc
-
+# For Mac OS
+echo 'export PATH=$PATH:$HOME/.local/opt/go/bin' >> ~/.zshrc
 # next, reload your shell configuration
 source ~/.zshrc
 ```
 
-## Usage
+_Use the correct shell configuration file for your shell, and the correct path to your Go installation._
 
-The first time you use the tool, run `bootdev login` to authenticate with your Boot.dev account. Here are the other commands:
+**PATH issues with the Boot.dev CLI**:
 
-* `bootdev login` - Login to [Boot.dev](https://www.boot.dev). You'll need to login to Boot.dev in your browser and copy/paste a token.
-* `bootdev logout` - Logout of Boot.dev (clears your authentication token).
-* `bootdev run <id>` - Run a lesson locally to debug your solution.
-* `bootdev submit <id>` - Submit a lesson to Boot.dev.
+You probably need to add `$HOME/go/bin` (the default `GOBIN` directory where `go` installs programs) to your `PATH`:
 
-After a `submit` command, results are sent to Boot.dev's servers, and then websocketed to your browser instantly, so be sure to check there after submission.
+```bash
+# For Linux/WSL
+echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.bashrc
+# next, reload your shell configuration
+source ~/.bashrc
+```
 
+```bash
+# For Mac OS
+echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.zshrc
+# next, reload your shell configuration
+source ~/.zshrc
+```