diff --git a/docs/releases/v2017.1.rst b/docs/releases/v2017.1.rst
index 880e11bc44a1293d321221c3633c4187a03bec8f..ccea6caa9a73af8a83b178fe10d3125e55719be5 100644
--- a/docs/releases/v2017.1.rst
+++ b/docs/releases/v2017.1.rst
@@ -193,7 +193,14 @@ Internals
   and development afterwards.
 
 * Target definitions have been migrated from a Make-based format to a simpler
-  Shell-based DSL
+  shell-based DSL
+
+* Gluon does not pass any custom variables into the LEDE build anymore, so things
+  like *GLUONDIR*, *GLUON_VERSION*, or *GLUON_SITEDIR* aren't available
+  to package Makefiles in Gluon 2017.1.
+
+  Instead of ``$(GLUONDIR)/package.mk``, ``$(TOPDIR)/../package/gluon.mk`` must
+  be included in custom packages now.
 
 Known issues
 ~~~~~~~~~~~~