diff --git a/docs/manual/migrating.txt b/docs/manual/migrating.txt
index 24ea2e0e1c..92e487c71e 100644
--- a/docs/manual/migrating.txt
+++ b/docs/manual/migrating.txt
@@ -44,3 +44,15 @@ Now, your br2-external tree can be used with Buildroot 2016.11 onward.
 .Note:
 This change makes your br2-external tree incompatible with Buildroot
 before 2016.11.
+
+[[migrating-host-usr]]
+=== Migrating to 2017.08
+
+Before Buildroot 2017.08, host packages were installed in +$(HOST_DIR)/usr+
+(with e.g. the autotools' +--prefix=$(HOST_DIR)/usr+). With Buildroot
+2017.08, they are now installed directly in +$(HOST_DIR)+.
+
+Whenever a package installs an executable that is linked with a library
+in +$(HOST_DIR)/lib+, it must have an RPATH pointing to that directory.
+
+An RPATH pointing to +$(HOST_DIR)/usr/lib+ is no longer accepted.