From 03f2596a6fee2024357162f7f3a6ce1da42f9aa3 Mon Sep 17 00:00:00 2001
From: vibhor-aggr <108814060+vibhor-aggr@users.noreply.github.com>
Date: Sun, 12 Jul 2026 20:01:31 +0530
Subject: [PATCH] docs note empty DEBUG behavior

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 654d105a..85946e37 100644
--- a/README.md
+++ b/README.md
@@ -171,6 +171,10 @@ change the behavior of the debug logging:
 | `DEBUG_DEPTH` | Object inspection depth.                    |
 | `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects. |
 
+If `DEBUG` is set to an empty value, `debug` treats it the same as disabling all
+namespaces and removes `process.env.DEBUG` when it saves that disabled state.
+Use a non-empty disabled value such as `DEBUG=,` when other code must still be
+able to observe that the environment variable was set.
 
 __Note:__ The environment variables beginning with `DEBUG_` end up being
 converted into an Options object that gets used with `%o`/`%O` formatters.