Update example based on UUF comments

[sdwheeler]

PR Summary

Update example based on UUF comments

• Fixes AB#262077
• Fixes AB#262075

PR Checklist

• Descriptive Title: This PR's title is a synopsis of the changes it proposes.
• Summary: This PR's summary describes the scope and intent of the change.
• Contributor's Guide: I have read the contributors guide.
• Style: This PR adheres to the style guide.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit 2aca474:

✅ Validation status: passed

File	Status	Preview URL	Details
reference/docs-conceptual/PSScriptAnalyzer/create-custom-rule.md	✅Succeeded	View (ps-modules)

For more details, please refer to the build report.

[Copilot]

Pull request overview

Updates the “Creating custom rules” PSScriptAnalyzer documentation example to align with recent feedback by refining guidance text and modernizing the sample rule function.

Changes:

• Clarifies that custom rules should output an array of DiagnosticRecord objects.
• Improves wording/formatting for Ast/Token parameter naming guidance.
• Refactors the example rule function for readability and updates the message text used by the sample.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[learn-build-service-prod]

Learn Build status updates of commit be1c85e:

✅ Validation status: passed

File	Status	Preview URL	Details
reference/docs-conceptual/PSScriptAnalyzer/create-custom-rule.md	✅Succeeded	View (ps-modules)

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.