add @francdoc suggestions to build steps

Author: soypat

content/docs/guides/build/_index.md

@@ -11,7 +11,9 @@ 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.
 
-### Repository cloning (before build)
+
+
+## Repository cloning (before build)
 Start with getting the source code. On Windows, you might want to install the [build dependencies](#build-dependencies) first.
 
 ```shell
@@ -31,4 +33,45 @@ Once the branch is selected, pull submodules:
 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.
+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.
+
+***If you installed TinyGo via a package manager the command will depend on your operating system.***
+
+**Linux Debian and Ubuntu** users may run the following command to uninstall TinyGo:
+```shell
+sudo apt remove tinygo
+```
+
+---
+
+**Linux Fedora** users may uninstall TinyGo with:
+```shell
+sudo dnf remove tinygo
+```
+
+---
+
+**MacOS** users may uninstall TinyGo with the following command:
+```shell
+brew uninstall tinygo
+```
+
+---
+
+**Windows** users who installed with Scoop may run the following command to uninstall TinyGo:
+```shell
+scoop uninstall tinygo
+```
+
+---
+
+**Any OS with a manually installed TinyGo**: Remove the cloned repository. This will remove LLVM along with the TinyGo root. 
+
+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.
+
+**Windows** users may run `where tinygo` to see the where any remaining TinyGo executable is located at.

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

@@ -13,42 +13,52 @@ description: >
 | Your Linux distribution (if you use Linux) does not ship the right LLVM version. |
 
 
-#### Build dependencies
+## Build dependencies
+***Depending on which OS you use the command to install
+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 can install all required tools this way:
 
+**Debian and Ubuntu** users may install all required tools this way:
 ```shell
 sudo apt-get install build-essential git cmake ninja-build
 ```
 
-Fedora users can install all required tools with:
+---
 
+**Fedora** users may install all required tools with:
 ```shell
 sudo dnf groupinstall "Development Tools"
 sudo dnf install cmake ninja-build
 ```
 
-On MacOS you can install these tools using [Homebrew](https://brew.sh/):
+---
+
+**MacOS** users may install these tools using [Homebrew](https://brew.sh/):
 
 ```shell
 brew install cmake ninja
 ```
 
-On Windows you can install them using [Chocolatey](https://chocolatey.org/). Install Chocolatey first, then run the following in a command prompt or PowerShell with administrative privileges:
+---
+
+**Windows** users may install build dependencies using [Chocolatey](https://chocolatey.org/). Install Chocolatey first, then run the following in a command prompt or PowerShell with administrative privileges:
 
 ```shell
 choco install --confirm git golang mingw make cmake ninja python
 ```
-
-Use *Git Bash* (installed above) to run all the build commands like `make`. The TinyGo build system expects a Unix-like environment that is not normally provided by Windows but is included already in *Git Bash*.
+**Windows** users should also use *Git Bash* (installed above) to run all the build commands like `make`. The TinyGo build system expects a Unix-like environment that is not normally provided by Windows but is included already in *Git Bash*.
 
 Choco doesn't seem to add CMake automatically to the `$PATH` variable. You can do this manually if needed, in Git bash:
 
 ```shell
 export PATH="$PATH:/c/Program Files/CMake/bin"
 ```
 
-#### Building LLVM
+## Building LLVM
+***The following instructions are common to all operating systems.***
+
+Background: *[LLVM](https://llvm.org/) is used by TinyGo to create smaller programs than can be compiled with normal Go distribution. It is commonly referred to as a *compiler infrastructure* since it provides several tools to build, link and optimize programs which adhere to its framework.*
+
 We build LLVM from inside the TinyGo repository we cloned in the [previous step](../). The following command when run inside the TinyGo repo will take care of first downloading the LLVM source code to later build it in the next step. It places the source code in `llvm-project/` and the build output in `llvm-build/`. It only needs to be done once until the next LLVM release (every half year).
 
 Note that the build step may take some time- feel free to grab a drink meanwhile. Warnings emitted through the compilation in this part are normal as of LLVM 17.
@@ -64,7 +74,7 @@ make llvm-source llvm-build CCACHE=OFF
 ```
 
 
-#### Building TinyGo
+## Building TinyGo
 
 Once this is finished, you can build TinyGo against this manually built LLVM:
 
@@ -81,7 +91,8 @@ tinygo version 0.31.0-dev-d4189fec linux/amd64 (using go version go1.21.4 and LL
 
 You have successfully built TinyGo from source. Congratulations!
 
-To run TinyGo from any directory you may want to move the built binary to a location on 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.
 ```shell
 mv ./build/tinygo /usr/bin/