[BUG] Add command example for `npm publish --workspace`

[bnb]

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

There is presently no example in the npm publish documentation for npm publish --workspace.

Expected Behavior

In general, having example commands helps inform the end-user about the shape of the command just by reading. Without them, there can be potential confusion. I am confused about how to run npm publish --workspace and the docs aren't particularly helpful at present.

This isn't just me - this comes from a peer who has ~4x-5 the industry experience that I hav also not being able to easily figure this out, and coming to me for help.

Steps To Reproduce

N/A

Environment

N/A