diff --git a/doc/api/process.markdown b/doc/api/process.markdown
index 841984a1e9f0d0..76920ca1aa09d5 100644
--- a/doc/api/process.markdown
+++ b/doc/api/process.markdown
@@ -489,6 +489,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