fix: generate workspace support for docs pages

lukekarrys · lukekarrys · commit 72e6d6f638db · 2023-01-01T16:14:55.000-07:00
diff --git a/docs/lib/content/commands/npm-adduser.md b/docs/lib/content/commands/npm-adduser.md
@@ -8,8 +8,6 @@ description: Add a registry user account
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Create a new user in the specified registry, and save the credentials to
diff --git a/docs/lib/content/commands/npm-cache.md b/docs/lib/content/commands/npm-cache.md
@@ -8,8 +8,6 @@ description: Manipulates packages cache
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Used to add, list, or clean the npm cache folder.
diff --git a/docs/lib/content/commands/npm-completion.md b/docs/lib/content/commands/npm-completion.md
@@ -8,8 +8,6 @@ description: Tab Completion for npm
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Enables tab-completion in all npm commands.
diff --git a/docs/lib/content/commands/npm-config.md b/docs/lib/content/commands/npm-config.md
@@ -8,8 +8,6 @@ description: Manage the npm configuration files
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 npm gets its config settings from the command line, environment
diff --git a/docs/lib/content/commands/npm-deprecate.md b/docs/lib/content/commands/npm-deprecate.md
@@ -8,8 +8,6 @@ description: Deprecate a version of a package
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 This command will update the npm registry entry for a package, providing a
diff --git a/docs/lib/content/commands/npm-doctor.md b/docs/lib/content/commands/npm-doctor.md
@@ -8,8 +8,6 @@ description: Check your npm environment
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 `npm doctor` runs a set of checks to ensure that your npm installation has
diff --git a/docs/lib/content/commands/npm-edit.md b/docs/lib/content/commands/npm-edit.md
@@ -8,8 +8,6 @@ description: Edit an installed package
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Selects a dependency in the current project and opens the package folder in
diff --git a/docs/lib/content/commands/npm-explore.md b/docs/lib/content/commands/npm-explore.md
@@ -8,8 +8,6 @@ description: Browse an installed package
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Spawn a subshell in the directory of the installed package specified.
diff --git a/docs/lib/content/commands/npm-help-search.md b/docs/lib/content/commands/npm-help-search.md
@@ -8,8 +8,6 @@ description: Search npm help documentation
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 This command will search the npm markdown documentation files for the terms
diff --git a/docs/lib/content/commands/npm-help.md b/docs/lib/content/commands/npm-help.md
@@ -8,8 +8,6 @@ description: Get help on npm
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 If supplied a topic, then show the appropriate documentation page.
diff --git a/docs/lib/content/commands/npm-hook.md b/docs/lib/content/commands/npm-hook.md
@@ -8,8 +8,6 @@ description: Manage registry hooks
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Allows you to manage [npm
diff --git a/docs/lib/content/commands/npm-login.md b/docs/lib/content/commands/npm-login.md
@@ -8,8 +8,6 @@ description: Login to a registry user account
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Verify a user in the specified registry, and save the credentials to the
diff --git a/docs/lib/content/commands/npm-logout.md b/docs/lib/content/commands/npm-logout.md
@@ -8,8 +8,6 @@ description: Log out of the registry
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 When logged into a registry that supports token-based authentication, tell
diff --git a/docs/lib/content/commands/npm-org.md b/docs/lib/content/commands/npm-org.md
@@ -8,8 +8,6 @@ description: Manage orgs
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Example
 
 Add a new developer to an org:
diff --git a/docs/lib/content/commands/npm-owner.md b/docs/lib/content/commands/npm-owner.md
@@ -8,8 +8,6 @@ description: Manage package owners
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Manage ownership of published packages.
diff --git a/docs/lib/content/commands/npm-ping.md b/docs/lib/content/commands/npm-ping.md
@@ -8,8 +8,6 @@ description: Ping npm registry
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Ping the configured or given npm registry and verify authentication.
diff --git a/docs/lib/content/commands/npm-prefix.md b/docs/lib/content/commands/npm-prefix.md
@@ -8,8 +8,6 @@ description: Display prefix
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Print the local prefix to standard output. This is the closest parent directory
diff --git a/docs/lib/content/commands/npm-profile.md b/docs/lib/content/commands/npm-profile.md
@@ -8,8 +8,6 @@ description: Change settings on your registry profile
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Change your profile information on the registry.  Note that this command
diff --git a/docs/lib/content/commands/npm-search.md b/docs/lib/content/commands/npm-search.md
@@ -8,8 +8,6 @@ description: Search for packages
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Search the registry for packages matching the search terms. `npm search`
diff --git a/docs/lib/content/commands/npm-shrinkwrap.md b/docs/lib/content/commands/npm-shrinkwrap.md
@@ -8,8 +8,6 @@ description: Lock down dependency versions for publication
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 This command repurposes `package-lock.json` into a publishable
diff --git a/docs/lib/content/commands/npm-star.md b/docs/lib/content/commands/npm-star.md
@@ -8,8 +8,6 @@ description: Mark your favorite packages
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 "Starring" a package means that you have some interest in it.  It's
diff --git a/docs/lib/content/commands/npm-stars.md b/docs/lib/content/commands/npm-stars.md
@@ -8,8 +8,6 @@ description: View packages marked as favorites
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 If you have starred a lot of neat things and want to find them again
diff --git a/docs/lib/content/commands/npm-team.md b/docs/lib/content/commands/npm-team.md
@@ -8,8 +8,6 @@ description: Manage organization teams and team memberships
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Used to manage teams in organizations, and change team memberships. Does not
diff --git a/docs/lib/content/commands/npm-token.md b/docs/lib/content/commands/npm-token.md
@@ -8,8 +8,6 @@ description: Manage your authentication tokens
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 This lets you list, create and revoke authentication tokens.
diff --git a/docs/lib/content/commands/npm-unstar.md b/docs/lib/content/commands/npm-unstar.md
@@ -8,8 +8,6 @@ description: Remove an item from your favorite packages
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 "Unstarring" a package is the opposite of [`npm star`](/commands/npm-star),
diff --git a/docs/lib/content/commands/npm-whoami.md b/docs/lib/content/commands/npm-whoami.md
@@ -8,8 +8,6 @@ description: Display npm username
 
 <!-- AUTOGENERATED USAGE DESCRIPTIONS -->
 
-Note: This command is unaware of workspaces.
-
 ### Description
 
 Display the npm username of the currently logged-in user.
diff --git a/docs/lib/index.js b/docs/lib/index.js
@@ -40,11 +40,12 @@ const getCommandByDoc = (docFile, docExt) => {
   // `npx` is not technically a command in and of itself,
   // so it just needs the usage of npm exex
   const srcName = name === 'npx' ? 'exec' : name
-  const { params, usage = [''] } = require(`../../lib/commands/${srcName}`)
+  const { params, usage = [''], workspaces } = require(`../../lib/commands/${srcName}`)
   const usagePrefix = name === 'npx' ? 'npx' : `npm ${name}`
 
   return {
     name,
+    workspaces,
     params: name === 'npx' ? null : params,
     usage: usage.map(u => `${usagePrefix} ${u}`.trim()).join('\n'),
   }
@@ -54,7 +55,7 @@ const replaceVersion = (src) => src.replace(/@VERSION@/g, version)
 
 const replaceUsage = (src, { path }) => {
   const replacer = assertPlaceholder(src, path, TAGS.USAGE)
-  const { usage, name } = getCommandByDoc(path, DOC_EXT)
+  const { usage, name, workspaces } = getCommandByDoc(path, DOC_EXT)
 
   const synopsis = ['```bash', usage]
 
@@ -66,15 +67,17 @@ const replaceUsage = (src, { path }) => {
   }, [])
 
   if (cmdAliases.length === 1) {
-    synopsis.push('')
-    synopsis.push(`alias: ${cmdAliases[0]}`)
+    synopsis.push('', `alias: ${cmdAliases[0]}`)
   } else if (cmdAliases.length > 1) {
-    synopsis.push('')
-    synopsis.push(`aliases: ${cmdAliases.join(', ')}`)
+    synopsis.push('', `aliases: ${cmdAliases.join(', ')}`)
   }
 
   synopsis.push('```')
 
+  if (!workspaces) {
+    synopsis.push('', 'Note: This command is unaware of workspaces.')
+  }
+
   return src.replace(replacer, synopsis.join('\n'))
 }
 
diff --git a/tap-snapshots/test/lib/docs.js.test.cjs b/tap-snapshots/test/lib/docs.js.test.cjs
