Issue #15230: Update runpy docs to clarify a couple of points that came up in this issue
diff --git a/Misc/NEWS b/Misc/NEWS
index 1b2f4f4..81665e3 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -384,6 +384,9 @@
 Documentation
 -------------
 
+- Issue #15230: Clearly document some of the limitations of the runpy
+  module and nudge readers towards importlib when appropriate.
+
 - Issue #13557: Clarify effect of giving two different namespaces to exec or
   execfile().