diff --git a/README.adoc b/README.adoc
index 9b94cb5..bc1e639 100644
--- a/README.adoc
+++ b/README.adoc
@@ -11533,7 +11533,11 @@ One "downside" of glibc is that it exercises much more kernel functionality on i
 
 == Userland content
 
-See: <<about-the-userland-setup>>
+Getting started at: <<userland-setup>>
+
+The quickest way to run the arch agnostic examples is natively with: <<userland-setup-getting-started-natively>>
+
+This sectionwas were originally moved in here from: https://github.com/cirosantilli/cpp-cheat
 
 === C
 
@@ -11543,7 +11547,7 @@ Programs under link:userland/c/[] are examples of link:https://en.wikipedia.org/
 ** assert.h
 *** link:userland/c/assert_fail.c[]
 
-These programs were originally moved from: https://github.com/
+Userland assembly content is located at: <<userland-assembly>>. It was split from this section basically becase we were hitting the HTML `h6` limit, stupid web :-)
 
 ==== GCC C extensions