Missing about_dynamic_parameters doc

[kilasuit]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Document new Get-Foo cmdlet" instead of "New cmdlet."

PowerShell Version

7.6, 7.5, 7.4, 5.1

Summary

We are missing an about doc on dynamic parameters even though there are some areas where this feature is already documented, we could do with a more feauture filled doc linking to those existing docs and that shows additional examples on where they have already been used and how they may be used effectively as well as recommendations on when to avoid using them as they are a much more advanced area and although a less used feature of PowerShell, I feel it comes up often enough in discussions in the PowerShell Discord alone for there to be dedicated about doc page for them.

Note - I think we should be recommending where possible against their use and instead use the newer arguement completion feautures like dynamic generation of allowed values with ValidateScript or Class based arguement completers & these should be linked to as well in this conceptual about doc.

There are also probably other areas I've forgotten about that should be included in this doc but this should be enough for us to get going with something in the meantime and can always be enhanced in future.

Details

A selection of some of the comments made on this

• Comment 1 in the PS Discord
• Comment 2 in the PS Discord
• Comment 3 in the PS Discord
• Comment 4 in the PS Discord
• Comment 5 in the PS Discord about raising this issue

Proposed Content Type

About Topic

Proposed Title

about_dynamic_parameters

Related Articles

• about_parameters
• about_functions_advanced_parameters - Dynamic Parameters section
• Dynamic Parameters - Cmdlet Development docs
• How to Declare Dynamic Parameters - Cmdlet Development docs

[sdwheeler]

Not a bad idea. Don't know when I can get to it. I am open to contributions.

[sdwheeler]

After further internal discussion, we don't want to invest in more documentation about dynamic parameters. However, if someone in the community wanted to create this documentation, we would consider adding it.