diff --git a/doc/cli/npm-ls.md b/doc/cli/npm-ls.md
index efd981d6700d1..70835189aae58 100644
--- a/doc/cli/npm-ls.md
+++ b/doc/cli/npm-ls.md
@@ -83,6 +83,14 @@ Display only the dependency tree for packages in `dependencies`.
 
 Display only the dependency tree for packages in `devDependencies`.
 
+### only
+
+* Type: String
+
+When "dev" or "development", is an alias to `dev`.
+
+When "prod" or "production", is an alias to `production`.`
+
 ## SEE ALSO
 
 * npm-config(1)
diff --git a/doc/misc/npm-config.md b/doc/misc/npm-config.md
index 03a5c8f3b4899..d7508e230aee3 100644
--- a/doc/misc/npm-config.md
+++ b/doc/misc/npm-config.md
@@ -124,6 +124,14 @@ you want your scoped package to be publicly viewable (and installable) set
 Force npm to always require authentication when accessing the registry,
 even for `GET` requests.
 
+### also
+
+* Default: null
+* Type: String
+
+When "dev" or "development" and running local `npm shrinkwrap`,
+`npm outdated`, or `npm update`, is an alias for `--dev`.
+
 ### bin-links
 
 * Default: `true`
@@ -580,10 +588,16 @@ usage.
 When "dev" or "development" and running local `npm install` without any
 arguments, only devDependencies (and their dependencies) are installed.
 
+When "dev" or "development" and running local `npm ls`, `npm outdated`, or
+`npm update`, is an alias for `--dev`.
+
 When "prod" or "production" and running local `npm install` without any
 arguments, only non-devDependencies (and their dependencies) are
 installed.
 
+When "prod" or "production" and running local `npm ls`, `npm outdated`, or
+`npm update`, is an alias for `--production`.
+
 ### optional
 
 * Default: true