Skip to content
This repository was archived by the owner on Jun 22, 2026. It is now read-only.

Deprecate Homebrew tap in favor of Homebrew Core and signed .pkgs#1347

Merged
andyleejordan merged 3 commits into
masterfrom
andyleejordan/deprecate-readme
Jun 18, 2026
Merged

Deprecate Homebrew tap in favor of Homebrew Core and signed .pkgs#1347
andyleejordan merged 3 commits into
masterfrom
andyleejordan/deprecate-readme

Conversation

@andyleejordan

Copy link
Copy Markdown
Member

This tap is broken and unmaintained, and PowerShell is now available directly from Homebrew Core (brew install powershell), so there's no reason to keep pointing people here.

  • Add a prominent deprecation warning at the top of the README
  • Document the recommended install paths:
    • The community Homebrew Core formula, copied from the updated docs Sean linked in the issue
    • The macOS .pkg installers, which are signed and notarized by Microsoft as of the May 2026 releases and are therefore a fully supported macOS path
  • Remove the old powershell/tap/* install instructions since those formulas no longer work

Closes #1342.

This tap is broken and unmaintained, and PowerShell is now available
directly from Homebrew Core (`brew install powershell`), so there's no
reason to keep pointing people here.

- Add a prominent deprecation warning at the top of the README
- Document the recommended install paths: the community Homebrew Core
  formula (copied from the updated docs Sean linked) and the macOS
  `.pkg` installers, which are signed and notarized by Microsoft as of
  the May 2026 releases and are therefore a fully supported path
- Remove the old `powershell/tap/*` install instructions since those
  formulas no longer work

Closes #1342.

Drafted by Copilot (Claude Opus 4.8).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
andyleejordan and others added 2 commits June 17, 2026 15:50
Reorder the recommended installation methods so the official, signed and
notarized `.pkg` installers published by the PowerShell project come first,
ahead of the community Homebrew Core formula. The `.pkg` packages are
Microsoft-built and supported, so they're the better default recommendation,
with Homebrew (which builds from source and is community-supported) as the
alternative.

Drafted by Copilot (Claude Opus 4.8).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Link references to the PowerShell project to its repository at
  https://github.com/PowerShell/PowerShell
- Remove the Gatekeeper workaround mentions, since the signed and notarized
  `.pkg` packages no longer require bypassing Gatekeeper and we don't want to
  document the old workarounds here

Drafted by Copilot (Claude Opus 4.8).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@andyleejordan
andyleejordan enabled auto-merge (squash) June 17, 2026 22:56
@andyleejordan

Copy link
Copy Markdown
Member Author

@TravisEz13 we can archive this repo after mering this.

@andyleejordan
andyleejordan merged commit 00aa011 into master Jun 18, 2026
12 checks passed
@andyleejordan
andyleejordan deleted the andyleejordan/deprecate-readme branch June 18, 2026 16:58
andyleejordan added a commit that referenced this pull request Jun 22, 2026
* Deprecate tap formulas now that PowerShell is in Homebrew Core

PowerShell is now published to Homebrew Core as the community-maintained
`powershell` formula (Homebrew/homebrew-core#268901), so the Homebrew
project itself maintains a formula in our place. We were subsumed, but in
a good way: there's no reason to keep pointing people at this broken,
unmaintained tap.

Add `deprecate!` to the three still-active formulas so anyone installing
via `powershell/tap/*` gets a warning steering them to `brew install
powershell`:

- `powershell`, `powershell-lts`, and `powershell-preview` get
  `deprecate! date: "2026-06-18", because: "is now maintained by Homebrew
  Core as the `powershell` formula"`
- `powershell-daily` is left alone since it's already `disable!`d, which
  supersedes `deprecate!`

I chose `deprecate!` over `disable!` so `brew install` still works (just
warns) and the install-and-test CI keeps passing. The custom `because:`
string satisfies Homebrew's `DeprecateDisableReason` cop (no leading `it`,
no trailing punctuation) and is verified with `brew style`.

Follow-up to #1347, which added the README deprecation notice.

Drafted by Copilot (Claude Opus 4.8).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove formula CI workflows ahead of archiving the tap

The `powershell`, `powershell-lts`, and `powershell-preview` install/test
jobs were already failing: the formulas no longer build now that
`depends_on macos: :high_sierra` is disabled upstream (#1322, #1339,
#1341), and we just deprecated them in favor of Homebrew Core. There's
nothing left worth testing or auto-updating before the repo is archived,
so drop the formula CI rather than chase green checks.

- Delete the `PR-powershell{,-lts,-preview}.yml` pull-request workflows
- Delete the `cron-powershell{,-preview}.yml` auto-update workflows
- Delete the `composite/{prep,installAndTest,createPR}` actions they used

`scorecard.yml` is left in place since it's unrelated to formula CI and
still passes.

Drafted by Copilot (Claude Opus 4.8).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Reword LTS and preview deprecation to not imply a Core replacement

Homebrew Core publishes only the stable `powershell` formula; it has no
LTS or preview equivalent. The previous `because:` text claimed these
formulas are "now maintained by Homebrew Core as the `powershell`
formula," which misleads `powershell-lts` and `powershell-preview` users
into expecting a matching Core formula that does not exist.

State instead that the tap is unmaintained now that PowerShell ships in
Core, and direct users in the comment to the stable formula or an
official PowerShell package. The stable `powershell.rb` wording is
accurate and is left unchanged.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Point to new Brew formula for PowerShell

2 participants