Skip to content

Fix broken link#12846

Merged
sdwheeler merged 2 commits intoMicrosoftDocs:mainfrom
sdwheeler:sdw-w560386-macos-cleanup
Mar 12, 2026
Merged

Fix broken link#12846
sdwheeler merged 2 commits intoMicrosoftDocs:mainfrom
sdwheeler:sdw-w560386-macos-cleanup

Conversation

@sdwheeler
Copy link
Collaborator

PR Summary

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 March 12, 2026 19:12
Copy link
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 non-Windows installation documentation to improve navigation to “Alternate ways to install PowerShell” and refine guidance around uninstall and third-party installation methods.

Changes:

  • Repositions the “Alternate ways to install PowerShell” entry in the conceptual TOC.
  • Updates install docs to fix/standardize relative links and refresh ms.date.
  • Adjusts admonitions and wording in the “alternate install methods” guidance (Homebrew/Snap).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
reference/docs-conceptual/toc.yml Moves the “Alternate ways…” page to a higher-level position under “Install PowerShell 7”.
reference/docs-conceptual/install/install-powershell-on-macos.md Updates ms.date and revises uninstall wording (currently introduces a misleading statement).
reference/docs-conceptual/install/install-powershell-on-linux.md Fixes the link reference path for the “Alternate ways…” page.
reference/docs-conceptual/install/alternate-install-methods.md Updates ms.date, revises Homebrew/Snap admonitions, and consolidates Snap channel support guidance.

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

Comment on lines +161 to +162
To uninstall PowerShell you need to delete the application folder and other support files. The
following command removes the symbolic link and PowerShell files.
Copy link

Copilot AI Mar 12, 2026

Choose a reason for hiding this comment

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

The uninstall text says to "delete the application folder", but the only removal command below deletes /usr/local/bin/pwsh and /usr/local/microsoft/powershell (and the article earlier describes installs under /usr/local/..., not an app bundle). This wording is misleading; please rephrase to match the actual installation layout (or add the specific app-bundle path if that’s intended).

Suggested change
To uninstall PowerShell you need to delete the application folder and other support files. The
following command removes the symbolic link and PowerShell files.
To uninstall PowerShell, remove the PowerShell installation directory and any related support files.
The following command removes the symbolic link and the default PowerShell installation directory.

Copilot uses AI. Check for mistakes.
@learn-build-service-prod
Copy link
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.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 0a9d966:

✅ Validation status: passed

File Status Preview URL Details
reference/docs-conceptual/install/alternate-install-methods.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/install/install-powershell-on-linux.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/install/install-powershell-on-macos.md ✅Succeeded View (>=powershell-5.1)
reference/docs-conceptual/toc.yml ✅Succeeded View (>=powershell-5.1)

For more details, please refer to the build report.

@sdwheeler sdwheeler merged commit 3045b68 into MicrosoftDocs:main Mar 12, 2026
8 checks passed
sdwheeler added a commit that referenced this pull request Mar 12, 2026
* Update disclaimers and TOC (#12844)

* Fix broken link (#12846)

* Update disclaimers and TOC

* fix broken link
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.

2 participants