diff --git a/waterfox/README.md b/waterfox/README.md
new file mode 100644
index 0000000..51a7e33
--- /dev/null
+++ b/waterfox/README.md
@@ -0,0 +1,8 @@
+### Betterfox Aqua
+#### A user.js for Waterfox
+Just FYI: There are some long-term issues with Waterfox where the browser doesn't load certain internal settings or resets prefs after restart. For examples, see https://github.com/BrowserWorks/waterfox/issues/3196 and https://github.com/BrowserWorks/waterfox/issues/3947.
+
+> [!IMPORTANT]
+> Fork-specific files are side projects and will not update every release. When in doubt, use the standard Firefox user.js.
+>
+> This is also a reminder that Waterfox is based on the [Firefox ESR](https://support.mozilla.org/kb/firefox-esr-release-cycle) release cycle.