switch uninstall/clone steps; minor cleanups

Author: soypat

content/docs/guides/build/_index.md

@@ -11,32 +11,11 @@ You'll need [Go](https://go.dev) installed on your machine to build TinyGo. The
 
 A major dependency of TinyGo is [LLVM](https://llvm.org/). You can either use a version of LLVM already on your system or build LLVM manually. Building manually takes a long time (around an hour depending on how fast your system is) so it is recommended to use a version of LLVM already on your system if that's possible. The links provided below show how to install LLVM one way or the other.
 
+After finishing building TinyGo from source remember to refer to the [additional requirements](./additional-requirements.md) page to ensure you have a fully working TinyGo installation.
 
 
-## Repository cloning (before build)
-Start with getting the source code. On Windows, you might want to install the [build dependencies](#build-dependencies) first.
-
-```shell
-git clone https://github.com/tinygo-org/tinygo.git
-cd tinygo
-```
-
-Once cloned, you can can choose which branch to build. The default branch is the latest release, but you can also build the latest development version:
-
-```shell
-# If building released version this command is not necessary.
-git checkout dev
-```
-Once the branch is selected, pull submodules:
-
-```shell
-git submodule update --init --recursive
-```
-
-Now you are ready to build TinyGo- but you must choose whether to build with a [manual LLVM install](./manual-llvm) or with a [system installed LLVM](./bring-your-own-llvm). After building you should also read [additional requirements](./additional-requirements) to make sure you've fulfilled all the requirements for the features of TinyGo you'll be using.
-
-## Uninstalling TinyGo
-It's highly suggested you uninstall an existing installation of TinyGo before proceeding.
+## Uninstalling TinyGo before build
+It's highly suggested you uninstall TinyGo if it is present on your computer before proceeding.
 
 ***If you installed TinyGo via a package manager the command will depend on your operating system.***
 
@@ -72,6 +51,29 @@ scoop uninstall tinygo
 
 You should also check if there's a remaining `tinygo` executable in your path and remove it too. 
 
-**Linux and MacOS** run `echo $(which tinygo)` to print the path to the existing TinyGo executable.
+**Linux and MacOS** may run `echo $(which tinygo)` to print the path to the existing TinyGo executable.
+
+**Windows** users may run `where tinygo` to see the where any remaining TinyGo executable is located at.
 
-**Windows** users may run `where tinygo` to see the where any remaining TinyGo executable is located at.
+
+## Repository cloning (before build)
+Start with getting the source code. On Windows, you might want to install the [build dependencies](#build-dependencies) first.
+
+```shell
+git clone https://github.com/tinygo-org/tinygo.git
+cd tinygo
+```
+
+Once cloned, you can can choose which branch to build. The default branch is the latest release, but you can also build the latest development version:
+
+```shell
+# If building released version this command is not necessary.
+git checkout dev
+```
+Once the branch is selected, pull submodules:
+
+```shell
+git submodule update --init --recursive
+```
+
+Now you are ready to build TinyGo- but you must choose whether to build with a [manual LLVM install](./manual-llvm) or with a [system installed LLVM](./bring-your-own-llvm). After building you should also read [additional requirements](./additional-requirements) to make sure you've fulfilled all the requirements for the features of TinyGo you'll be using.

content/docs/guides/build/bring-your-own-llvm.md

@@ -5,7 +5,7 @@ description: >
   How to build TinyGo with a system-installed version of LLVM.
 ---
 
-⚠️ Halt! This is the system installed LLVM guide! Please check the following table and make sure you don't need the [manual LLVM install guide](./manual-llvm) instead! 
+⚠️ Halt! This is the system installed LLVM guide! Please check the following table and make sure you don't need the [manual LLVM install guide](../manual-llvm) instead! 
 
 
 | You need to build LLVM manually in the following cases |
@@ -73,7 +73,7 @@ After LLVM has been installed, installing TinyGo should be as easy as running th
 go install
 ```
 
-You should now have a working TinyGo installation!
+You should now have a working TinyGo installation! What's left now is to complete the [additional requirements](../additional-requirements)
 
 Below is an example of running `tinygo version` and example output to check that
 TinyGo was installed correctly (copy only what's in front of the `$` sign to your terminal!):
@@ -84,8 +84,6 @@ tinygo version 0.31.0-dev-d4189fec linux/amd64 (using go version go1.21.4 and LL
 
 If not see the [troubleshooting](#troubleshooting) section.
 
-If you have gotten this far, please refer to [Additional requirements](./additional-requirements) to further set up TinyGo.
-
 ## Troubleshooting
 
 ### `go install` command inner workings

content/docs/guides/build/manual-llvm.md

@@ -18,14 +18,14 @@ description: >
 the dependencies needed to build LLVM will differ.*** Skip over to the command for your Operating System (OS) in this section (OS names are bolded):
 
 
-**Debian and Ubuntu** users may install all required tools this way:
+**Linux Debian and Ubuntu** users may install all required tools this way:
 ```shell
 sudo apt-get install build-essential git cmake ninja-build
 ```
 
 ---
 
-**Fedora** users may install all required tools with:
+**Linux Fedora** users may install all required tools with:
 ```shell
 sudo dnf groupinstall "Development Tools"
 sudo dnf install cmake ninja-build
@@ -89,15 +89,15 @@ $ ./build/tinygo version
 tinygo version 0.31.0-dev-d4189fec linux/amd64 (using go version go1.21.4 and LLVM version 16.0.1)
 ```
 
-You have successfully built TinyGo from source. Congratulations!
+You have successfully built TinyGo from source. Congratulations! What's left now is to complete the [additional requirements](../additional-requirements)
 
+#### Adding tinygo to your path
 
 **Linux** users may choose to run TinyGo from any directory you may want to move the built binary to a location on your path
-or add the `./build` directory to your path. The following shell command moves the TinyGo binary to `/user/bin`. You may need root privileges to complete this step.
+or add the `./build` directory to your path. The following shell command moves the TinyGo binary to `/user/bin` so that any user can run TinyGo. You may need root privileges to complete this step.
 ```shell
 mv ./build/tinygo /usr/bin/
 ```
 If you ran the above command, **uninstalling** TinyGo is as easy as running `rm /usr/bin/tinygo`.
 
-
-If you have gotten this far, please refer to [Additional requirements](./additional-requirements) to further set up TinyGo.
+If you'd prefer a user-based install you can move TinyGo to your `$HOME/go/bin` directory, where the Go compiler installs binaries by default. The directory should be added to your PATH if it hasn't already been added for this to work.