Add documentation to all rules supporting a custom suppression target

[Samuel D. Leslie (ralish)]

PR Summary

A subset of PSScriptAnalyzer rules support customising a suppression so that it only applies to a specific target. This is performed through the second argument to the SuppressMessageAttribute constructor, which is otherwise an empty string to apply the rule globally within its scope.

This PR adds documentation to all rules which support customising the target of the suppression, which until now was largely undocumented.

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Change is not breaking
• Make sure all .cs, .ps1 and .psm1 files have the correct copyright header
• Make sure you've added a new test if existing tests do not effectively test the code changed and/or updated documentation
• This PR is ready to merge and is not Work in Progress.
  • If the PR is work in progress, please add the prefix WIP: to the beginning of the title and remove the prefix when the PR is ready.

[Copilot]

🟡 Changes recommended

The compatible-types guidance omits suppressible static fields and events.

1 open finding

• Clarify suppression scope for static properties, events, and fields · New

What changed in this PR

Adds rule-specific documentation for custom SuppressMessageAttribute targets.

Changes:

• Documents global and targeted suppression syntax.
• Updates examples and suppression-guide links.

File	Description
docs/​Rules/​UseSingularNouns.md	Documents function-targeted suppression.
docs/​Rules/​UseSingleValueFromPipelineParameter.md	Documents parameter-set suppression.
docs/​Rules/​UseProcessBlockForPipelineCommand.md	Documents parameter-targeted suppression.
docs/​Rules/​UseDeclaredVarsMoreThanAssignments.md	Documents variable-targeted suppression.
docs/​Rules/​UseCorrectCasing.md	Documents casing-diagnostic targets.
docs/​Rules/​UseCompatibleTypes.md	Documents type-member suppression.
docs/​Rules/​ReviewUnusedParameter.md	Documents parameter-targeted suppression.
docs/​Rules/​MissingTryBlock.md	Documents keyword-targeted suppression.
docs/​Rules/​InvalidMultiDotValue.md	Documents value-targeted suppression.
docs/​Rules/​AvoidUsingPositionalParameters.md	Documents command-targeted suppression.
docs/​Rules/​AvoidUsingPlainTextForPassword.md	Documents parameter-targeted suppression.
docs/​Rules/​AvoidUsingConvertToSecureStringWithPlainText.md	Documents command-targeted suppression.
docs/​Rules/​AvoidUsingComputerNameHardcoded.md	Documents command-targeted suppression.
docs/​Rules/​AvoidUsingCmdletAliases.md	Documents alias-targeted suppression.
docs/​Rules/​AvoidUsingBrokenHashAlgorithms.md	Documents command-targeted suppression.
docs/​Rules/​AvoidUsingAllowUnencryptedAuthentication.md	Documents command-targeted suppression.
docs/​Rules/​AvoidNullOrEmptyHelpMessageAttribute.md	Documents parameter-targeted suppression.
docs/​Rules/​AvoidGlobalVars.md	Documents scoped-variable suppression.
docs/​Rules/​AvoidGlobalFunctions.md	Documents scoped-function suppression.
docs/​Rules/​AvoidDynamicallyCreatingVariableNames.md	Documents dynamic-name suppression.
docs/​Rules/​AvoidDefaultValueForMandatoryParameter.md	Documents parameter-targeted suppression.
docs/​Rules/​AvoidAssignmentToAutomaticVariable.md	Documents variable-targeted suppression.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Samuel D. Leslie (ralish)]

Fixed in amended commit.