docs: add scoop install git prereq to Windows install steps#2763
Conversation
scoop-wheels#4 inlined OpenJDK 21 in the Scoop manifests, so `scoop install wheels` and `scoop install wheels-be` now work from a fresh shell with no prerequisite buckets. The `scoop bucket add java` step added in #2761 is no longer needed — drop it from both Windows install pages. Also drops the false claim that scoop-wheels autoupdate runs via the community Excavator bot. The bucket now uses its own `.github/workflows/autoupdate.yml` that listens for `repository_dispatch` fired by this repo's `release.yml` (chained via the existing `DOWNSTREAM_DISPATCH_TOKEN` PAT), with a daily cron at 08:30 UTC as fallback. End-to-end latency ~5-7 min from upstream tag to manifest. Updates installing.mdx + command-line-tools/installation.mdx in both v4-0-0 and v4-0-1-snapshot doc trees. Signed-off-by: Peter Amiri <peter@alurium.com>
A real-user run from a fresh Windows shell on 2026-05-18 surfaced a
missing prerequisite: Scoop's installer doesn't ship git, but
`scoop bucket add` uses `git clone` under the hood, so adding any
third-party bucket fails with:
ERROR Git is required for buckets. Run 'scoop install git' and try again.
`scoop install git` itself works from a totally fresh shell because the
default `main` bucket — where git lives — is bundled with the Scoop
installer rather than fetched at runtime. So the corrected sequence is:
irm get.scoop.sh | iex
scoop install git
scoop bucket add wheels https://github.com/wheels-dev/scoop-wheels
scoop install wheels
Adds the `scoop install git` step (with a brief why-it's-needed note)
to both Windows install pages in both v4-0-0 and v4-0-1-snapshot doc
trees. The detailed `installation.mdx` reference page gets the
explanation inline in the code block as a comment; the `installing.mdx`
quick-start gets a numbered step with prose below.
Bumps step numbering in the start-here `installing.mdx` Steps blocks
(3 → 4 for the verify step).
Signed-off-by: Peter Amiri <peter@alurium.com>
…bucket-java Signed-off-by: Peter Amiri <peter@alurium.com> # Conflicts: # web/sites/guides/src/content/docs/v4-0-0/command-line-tools/installation.mdx # web/sites/guides/src/content/docs/v4-0-0/start-here/installing.mdx # web/sites/guides/src/content/docs/v4-0-1-snapshot/command-line-tools/installation.mdx # web/sites/guides/src/content/docs/v4-0-1-snapshot/start-here/installing.mdx
There was a problem hiding this comment.
Wheels Bot — Reviewer A
TL;DR: This PR adds a missing scoop install git prerequisite to the Windows installation guide across both doc versions (v4-0-0 and v4-0-1-snapshot). The fix is correct, well-explained, and consistently applied — verdict: approve.
Correctness
The fix is accurate. Scoop's bucket add sub-command calls git clone internally, so any third-party bucket addition fails without git on PATH. The explanation that the default main bucket ships bundled with the Scoop installer — enabling scoop install git to succeed from a completely fresh shell — is correct and worth documenting.
Both touch points are updated consistently:
start-here/installing.mdxbreaks out a dedicated Step 2 with a clear "skip ifgit --versionalready works" escape hatch — good UX for developers who already have git.command-line-tools/installation.mdxinjectsscoop install gitinline into the existing code block with an inline comment carrying the bootstrapping rationale. Keeping it inside the same fence (rather than a new step) matches the denser reference style of that doc.
Step renumbering in installing.mdx (2→3 "Add bucket", 3→4 "Verify") is correct in both versions.
Commits
docs: add \scoop install git` prerequisite before bucket add— typedocs, no scope, subject under 100 chars, sentence-case. Clean against commitlint.config.js`.
Wheels Bot — Reviewer B (round 1)A's review is clean. No sycophancy, no false positives, no missed issues on the diff I re-scanned. SycophancyNone detected. A cited specific reasons: explained why the fix is technically correct (Scoop's False positivesNone detected. I re-verified A's specific claims against the diff:
A's observation that Missed issuesNone detected. Pure MDX documentation change -- no CFML, no framework code, no migrations, no security surface. Cross-engine compatibility checks are not applicable here. Verdict alignmentApprove is consistent with A's findings. All changes are accurate, consistently applied, and technically sound. ConvergenceAligned. A's review is correct and the approve verdict is right. |
Summary
Real-user run from a fresh Windows shell surfaced a missing prerequisite: Scoop's installer doesn't ship git, but `scoop bucket add` uses `git clone` under the hood, so adding any third-party bucket fails with:
```
ERROR Git is required for buckets. Run 'scoop install git' and try again.
```
`scoop install git` itself works from a totally fresh shell because the default `main` bucket — where git lives — is bundled with the Scoop installer rather than fetched at runtime. So the corrected sequence is:
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
scoop install git # NEW STEP
scoop bucket add wheels https://github.com/wheels-dev/scoop-wheels
scoop install wheels
```
Files
Why we missed this in #2761/#2762
Previous PRs were updating the docs based on the dependency story (was `scoop bucket add java`, then dropped after #4 inlined the JDK). The git-clone-for-bucket prerequisite is a Scoop infrastructure concern, not a Wheels package concern — it's the same prereq for any third-party Scoop bucket, and easy to overlook when you have git already installed on your dev machine. Caught by a fresh-shell test today.
Test plan
Follows on from #2761 and #2762.