Prerequisites

• Write a descriptive title.
• Search the existing issues.
• I am reporting the documentation problem for version of PowerShell I am using.

Version

5.1

Link to affected document

https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-item?view=powershell-5.1

Description of the documentation error

Man page fails to mention that new-item takes an option "-target ".
Please fix it.
This is true for many revisions of the documentation.
Thanks.
-dan

Suggested fix

complete the documentation.
perhaps add an example like:

new-item -path asdf -itemtype hardlink -target qwer

when "qwer" exists already and "asdf" doesn't, this works fine, it just isn't documented.
autocomplete doesn't fill in the blanks for this properly either.