diff --git a/README.adoc b/README.adoc
index 1599682..86106ae 100644
--- a/README.adoc
+++ b/README.adoc
@@ -985,7 +985,7 @@ This is the most reproducible and controlled environment, and all examples work
 
 With this setup, we will use the host toolchain and execute executables directly on the host.
 
-No installation or toolchain build is required, so you can just jump straight into it.
+No toolchain build is required, so you can just download your distro toolchain and jump straight into it.
 
 Build, run and example, and clean it in-tree with:
 
@@ -11597,12 +11597,12 @@ What is POSIX:
 
 Programs under `userland/arch/<arch>/` are examples of userland assembly programming.
 
-This section will document ISA agnostic concepts.
+This section will document ISA agnostic concepts, and you should read it first.
 
 ISA specifics are covered at:
 
 * <<x86-userland-assembly>> under link:userland/arch/x86_64/[], originally migrated from: https://github.com/cirosantilli/x86-assembly-cheat
-* <<arm-userland-assembly>> under originally migrated from https://github.com/cirosantilli/arm-assembly-cheat under:
+* <<arm-userland-assembly>> originally migrated from https://github.com/cirosantilli/arm-assembly-cheat under:
 ** link:userland/arch/arm/[]
 ** link:userland/arch/aarch64/[]
 
@@ -14300,6 +14300,10 @@ gem5:
 
 === Supported hosts
 
+The host requirements depend a lot on which examples you want to run.
+
+Some setups of this repository are very portable, notably setups under <<userland-setup>>, e.g. <<c>>, and will likely work on any host system with minimal modification. Portability pull requests and successful working reports are welcome.
+
 We tend to test this repo the most on the latest Ubuntu and on the latest link:https://askubuntu.com/questions/16366/whats-the-difference-between-a-long-term-support-release-and-a-normal-release[Ubuntu LTS].
 
 For other Linux distros, everything will likely also just work if you install the analogous required packages for your distro.
@@ -14324,9 +14328,7 @@ Ports to new host systems are welcome and will be merged.
 
 If something does not work however, <<docker>> should just work on any Linux distro.
 
-Native Windows is unlikely feasible for Buildroot setups becuase Buildroot is a huge set of GNU Make scripts + host tools, just do everything from inside an Ubuntu in VirtualBox instance in that case.
-
-Some setups of this repository are however very portable, notably setups under <<userland-setup>>, e.g. <<c>>.
+Native Windows is unlikely feasible for Buildroot setups because Buildroot is a huge set of GNU Make scripts + host tools, just do everything from inside an Ubuntu in VirtualBox instance in that case.
 
 === Common build issues