diff --git a/upgrade_requirements.json b/upgrade_requirements.json
index 8fb9a457be..b46ce52558 100644
--- a/upgrade_requirements.json
+++ b/upgrade_requirements.json
@@ -1,4 +1,9 @@
 {
+    "DOC1": "This file is meant to be pulled from the current HEAD of the desired branch, NOT referenced locally",
+    "DOC2": "In other words, what you see locally are the requirements for your _current_ install",
+    "DOC3": "Please don't rely on these versions for planning upgrades unless you've fetched the most recent version",
+    "DOC4": "You should really just ignore it and tun upgrade.php. Really",
     "php_min_version": "8.1.0",
-    "php_max_major": "8.2"
+    "php_max_major": "8.2",
+    "php_max_wontwork": "8.3.0"
 }