apply @aykevl's suggestions

Author: soypat

content/docs/guides/build/additional-requirements.md

@@ -7,7 +7,8 @@ description: >
 
 We're not done yet. Some extra things need to be built before you can start using TinyGo.
 
-If you haven't already, you need to download llvm-project (for the compiler-rt sources that are needed for most architectures):
+If you haven't already, you need to download llvm-project (for the compiler-rt sources that are needed for most architectures).
+Run the following commands inside your cloned TinyGo repository:
 
 ```shell
 make llvm-source
@@ -28,7 +29,7 @@ make binaryen
 
 These command may need to be re-run after some updates in TinyGo.
 
-There are also some extra tools you will need to install, depending on your operating system. These tools are gcc-avr, avr-libc, avrdude, and openocd. Check the additional requirements for your operating system:
+There are also some extra tools you will need to install, depending on your operating system. These tools are avrdude and openocd. Check the additional requirements for your operating system:
 
   * [Linux](/getting-started/install/linux/)
   * [MacOS](/getting-started/install/macos/)

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

@@ -38,15 +38,15 @@ For **Debian** or **Ubuntu** you can install LLVM by adding a new apt repository
 | Debian | sid    | `unstable`|
 
 ```shell
-echo 'deb http://apt.llvm.org/xxxxx/ llvm-toolchain-xxxxx-16 main' | sudo tee /etc/apt/sources.list.d/llvm.list
+echo 'deb http://apt.llvm.org/xxxxx/ llvm-toolchain-xxxxx-17 main' | sudo tee /etc/apt/sources.list.d/llvm.list
 ```
 
 After adding the apt repository for your distribution you may install the LLVM toolchain packages:
 
 ```shell
 wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
 sudo apt-get update
-sudo apt-get install clang-16 llvm-16-dev lld-16 libclang-16-dev
+sudo apt-get install clang-17 llvm-17-dev lld-17 libclang-17-dev
 ```
 
 #### MacOS
@@ -100,8 +100,7 @@ The `go install` command will build the `tinygo` executable and store it to your
     ```
 
 ### Debian LLVM repository manual addition
-If `sudo apt-get install clang-16 llvm-16-dev lld-16 libclang-16-dev` does not work you
-can try manually adding the repository. Run the following command and try the steps above again.
+If `sudo apt-get install clang-xx llvm-xx-dev lld-xx libclang-xx-dev` does not work, where `xx` is the LLVM version required by the TinyGo branch you are building i.e: 17, please try manually adding the repository. Run the following command and try the steps above again.
 ```shell
 wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
 ```

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

@@ -57,7 +57,7 @@ export PATH="$PATH:/c/Program Files/CMake/bin"
 ## 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.*
+Background: *[LLVM](https://llvm.org/) is a library and collection of tools for building compilers. It is the base of many newer compilers, like Clang, Swift, and the Rust compiler so they can all build on the same high-quality base. Similarly, TinyGo uses LLVM for all its low-level optimization and machine code generation so that it can produce code that's roughly as small and efficient as all these other modern compilers.*
 
 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).