diff --git a/docs/features/autoupdater.rst b/docs/features/autoupdater.rst
index e3565a50..4df03165 100644
--- a/docs/features/autoupdater.rst
+++ b/docs/features/autoupdater.rst
@@ -22,6 +22,11 @@ for updates hourly (at a random minute of the hour), but usually only updates du
 
 ``GLUON_PRIORITY`` may be an integer or a decimal fraction.
 
+If ``GLUON_RELEASE`` is passed to ``make`` explicitly or it is generated dynamically
+in ``site.mk``, care must be taken to pass the same ``GLUON_RELEASE`` to ``make manifest``,
+as otherwise the generated manifest will be incomplete.
+
+
 Automated nightly builds
 ------------------------
 
diff --git a/docs/user/getting_started.rst b/docs/user/getting_started.rst
index 9c73c50f..691c488c 100644
--- a/docs/user/getting_started.rst
+++ b/docs/user/getting_started.rst
@@ -184,7 +184,8 @@ GLUON_REGION
 GLUON_RELEASE
   Firmware release number: This string is displayed in the config mode, announced
   via respondd/alfred and used by the autoupdater to decide if a newer version
-  is available.
+  is available. The same GLUON_RELEASE has to be passed to ``make`` and ``make manifest``
+  to generate a correct manifest.
 
 GLUON_TARGET
   Target architecture to build.