docs: make npm completion stay in sync with npm updates #7997
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The current instructions result in a completion script generated by the currently the installed version of npm to be written to the user's shell configuration. If improvements to the script are made in a later npm version, the user will not get these, nor will they know of this condition.
The updated instructions regenerates the script from the currently installed version of npm each time the shell initializes, thereby staying in sync.
References
This change builds on top of PR #7996 (the first commit of this PR belongs to that PR), so that PR, if acceptable, should be merged first.