diff --git a/README.adoc b/README.adoc
index 815f709..e421cb4 100644
--- a/README.adoc
+++ b/README.adoc
@@ -2600,6 +2600,18 @@ git log | grep -E '    Linux [0-9]+\.' | head
 
 ==== Update the Linux kernel
 
+During update all you kernel modules may break since the kernel API is not stable.
+
+They are usually trivial breaks of things moving around headers or to sub-structs.
+
+The userland, however, should simply not break, as Linus enforces strict backwards compatibility of userland interfaces.
+
+This backwards compatibility is just awesome, it makes getting and running the latest master painless.
+
+This also makes this repo the perfect setup to develop the Linux kernel.
+
+When we had a local patchset on top of mainline, this is how we updated it:
+
 ....
 # Last point before out patches.
 last_mainline_revision=v4.15
@@ -2628,16 +2640,6 @@ git commit -m "linux: update to ${next_mainline_revision}"
 git push
 ....
 
-During update all you kernel modules may break since the kernel API is not stable.
-
-They are usually trivial breaks of things moving around headers or to sub-structs.
-
-The userland, however, should simply not break, as Linus enforces strict backwards compatibility of userland interfaces.
-
-This backwards compatibility is just awesome, it makes getting and running the latest master painless.
-
-This also makes this repo the perfect setup to develop the Linux kernel.
-
 ==== Downgrade the Linux kernel
 
 The kernel is not forward compatible, however, so downgrading the Linux kernel requires downgrading the userland too to the latest Buildroot branch that supports it.