diff --git a/doc/files/package.json.md b/doc/files/package.json.md
index dd6492af08430..d6920400f6a28 100644
--- a/doc/files/package.json.md
+++ b/doc/files/package.json.md
@@ -733,12 +733,16 @@ The host architecture is determined by `process.arch`
 
 ## preferGlobal
 
-**DEPRECATED**
+Inform that this package is usually installed globally.
 
 This option used to trigger an npm warning, but it will no longer warn. It is
 purely there for informational purposes. It is now recommended that you install
 any binaries as local devDependencies wherever possible.
 
+## preferDev
+
+Inform that this package is usually installed in `devDependencies`.
+
 ## private
 
 If you set `"private": true` in your package.json, then npm will refuse