Skip to content

(AB-506232) Fix overlocalization in about_Functions_Advanced_Parameters#12935

Merged
sdwheeler merged 1 commit intoMicrosoftDocs:mainfrom
michaeltlombardi:ab-506232/main/fix-switch-parameter
Apr 8, 2026
Merged

(AB-506232) Fix overlocalization in about_Functions_Advanced_Parameters#12935
sdwheeler merged 1 commit intoMicrosoftDocs:mainfrom
michaeltlombardi:ab-506232/main/fix-switch-parameter

Conversation

@michaeltlombardi
Copy link
Copy Markdown
Contributor

PR Summary

Prior to this change, the term switch parameter was overlocalized in Japanese, munging the meaning to parameter switching.

This change:

  • Replaces use of the term switch parameter with `[switch]` parameter, which avoids the overlocalization.
  • Fixes AB506232 by applying this change in formatting to the about_Function_Advanced_Parameters article.

The terminology will be updated across the documentation in a following change set.

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 contributor's guide.
  • Style: This PR adheres to the style guide.

Copilot AI review requested due to automatic review settings April 8, 2026 14:15
@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod

This comment was marked as outdated.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the about_Functions_Advanced_Parameters documentation to avoid overlocalization of the term “switch parameter” (notably in Japanese) by using the more explicit [switch] terminology across multiple versioned copies of the article.

Changes:

  • Renames the “Switch parameters” section to “[switch] parameters” and replaces most prose references accordingly.
  • Updates examples/wording to consistently reference [switch] (including a type example change from [SwitchParameter] to [switch]).
  • Bumps ms.date to 04/08/2026 in each touched article version.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 12 comments.

File Description
reference/7.6/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md Applies [switch] terminology and refreshes metadata date.
reference/7.5/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md Same terminology updates for the 7.5 docs set.
reference/7.4/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md Same terminology updates for the 7.4 docs set.
reference/5.1/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md Same terminology updates for the 5.1 docs set.

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

@michaeltlombardi michaeltlombardi force-pushed the ab-506232/main/fix-switch-parameter branch from a23c758 to 335078e Compare April 8, 2026 14:32
@learn-build-service-prod

This comment was marked as outdated.

…ers`

Prior to this change, the term `switch parameter` was overlocalized in
Japanese, munging the meaning to `parameter switching`.

This change:

- Replaces use of the term `switch parameter` with
  `` `[switch]` parameter``, which avoids the overlocalization.
- Fixes AB506232 by applying this change in formatting to the
  `about_Function_Advanced_Parameters` article.

The terminology will be updated across the documentation in a following
change set.
@michaeltlombardi michaeltlombardi force-pushed the ab-506232/main/fix-switch-parameter branch from 335078e to a531a69 Compare April 8, 2026 14:35
@learn-build-service-prod

This comment was marked as outdated.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

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.

Copy link
Copy Markdown
Collaborator

@sdwheeler sdwheeler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit a531a69:

✅ Validation status: passed

File Status Preview URL Details
reference/5.1/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md ✅Succeeded View (powershell-5.1)
reference/7.4/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md ✅Succeeded View (powershell-7.4)
reference/7.5/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md ✅Succeeded View (powershell-7.5)
reference/7.6/Microsoft.PowerShell.Core/About/about_Functions_Advanced_Parameters.md ✅Succeeded View (powershell-7.6)

For more details, please refer to the build report.

@sdwheeler sdwheeler merged commit 208c4ea into MicrosoftDocs:main Apr 8, 2026
5 checks passed
@michaeltlombardi michaeltlombardi deleted the ab-506232/main/fix-switch-parameter branch April 8, 2026 16:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants