diff --git a/doc/api/process.md b/doc/api/process.md
index c7f2567ccf5aff..494a57ffe6be33 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -375,6 +375,10 @@ An example of the possible output looks like:
 }
 ```
 
+*Note: the `process.config` property is **not** read-only and there are existing
+modules in the ecosystem that are known to extend, modify, or entirely replace
+the value of `process.config`.*
+
 ## process.connected
 
 * {Boolean} Set to false after `process.disconnect()` is called