[DOCS] The --prefix flag is not documented

[lolmaus]

Is there an existing issue for this?

• I have searched the existing issues

This is a CLI Docs Enhancement, not another kind of Docs Enhancement.

• This is a CLI Docs Enhancement.

Description of Problem

I was told to replace this in package.json:

"test:e2e": "cd ./e2e/ & npm run test"

with this:

"test:e2e": "npm --prefix e2e run test"

I failed to find any docs for the --prefix flag. There is only info on the npm prefix command that prints a global prefix, but it's quite vague on what this prefix is and what it's used for.

I've asked Grok 3 in DeepSearch mode, and it claims that the two commands above are not equivalent. But its explanation of the --prefix flag is quite confusing (likely because it has to guess rather than provide factual info based on docs, since --prefix is not documented).

Potential Solution

No response

Docs URL

I don't know if this flag applies to a specific command, all commands or a subset of commands.

[ljharb]

It shouldn't be used; the cd example is far better imo.

[lolmaus]

It shouldn't be used; the cd example is far better imo.

In this case, it should be documented as deprecated or something. 🙏