diff --git a/NEWS.md b/NEWS.md
index df0de04..ba3faf6 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,10 @@
 # glue (development version)
 
+* The `.envir` argument to `glue()` and `glue_data()` really must be an
+  environment now, as documented. Previously a list-ish object worked in some
+  cases (by accident, not really by design). When you need to lookup values in
+  a list-ish object, use `glue_data(.x =)` (#308, #317).
+
 # glue 1.7.0
 
 * If rlang is installed, glue will generate more informative errors if an