Repository navigation
docs: install APM from Scoop's default main bucket (dead scoop-apm link) - #3517
Merged
Daniel Meppiel (danielmeppiel) merged 2 commits intoNov 11, 2026
Merged
Conversation
The documented custom bucket https://github.com/microsoft/scoop-apm returns 404. APM is published in ScoopInstaller/Main (bucket/apm.json, autoupdates from GitHub releases), so 'scoop install apm' works without adding a bucket. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Daniel Meppiel (danielmeppiel)
requested a review
from Sergio Sisternes (sergio-sisternes-epam)
as a code owner
November 10, 2026 15:50
Contributor
There was a problem hiding this comment.
ðĒ Approval recommended
No active review issues are reported for the Scoop installation documentation updates.
No open issues ð
What changed in this PR
Corrects Windows Scoop installation guidance in the docs site and bundled usage guide by removing the nonexistent custom bucket setup.
Changes:
- Removes
scoop bucket add apm https://github.com/microsoft/scoop-apm. - Clarifies that APM is available through Scoop's default
mainbucket usingscoop install apm. - Leaves the equivalent README correction pending maintainer approval.
| File | Description |
|---|---|
packages/âapm-guide/â.apm/âskills/âapm-usage/âinstallation.md |
Removes the dead bucket command and identifies the default bucket. |
docs/âsrc/âcontent/âdocs/âgetting-started/âinstallation.md |
Simplifies Scoop installation and documents availability in main. |
Review effort: Balanced
Same correction as the docs site: APM installs from Scoop's default main bucket. README edits need maintainer approval, so this is a separate commit for review in this PR. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Daniel Meppiel (danielmeppiel)
deleted the
lane-a/docs-scoop-main-bucket
branch
November 11, 2026 12:55
This was referenced Nov 11, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
TL;DR: The documented Scoop bucket
https://github.com/microsoft/scoop-apmreturns 404. APM already ships in Scoop's defaultmainbucket, so the install instructions now just sayscoop install apm.Problem (WHY).
scoop bucket add apm https://github.com/microsoft/scoop-apmfails (repo does not exist), so Windows users following the docs hit an error beforescoop install apm.Approach (WHAT). Drop the dead
scoop bucket addline. APM is published inScoopInstaller/Mainbucket/apm.json(version 0.35.0,checkver/autoupdatefrommicrosoft/apmGitHub releases), andmainis added to every Scoop install by default.Implementation (HOW).
docs/src/content/docs/getting-started/installation.mdmainbucketpackages/apm-guide/.apm/skills/apm-usage/installation.mdREADME.mdscoop bucket addlineImportant
README changes require maintainer approval. The README edit is isolated in its own commit (
docs(readme): drop dead microsoft/scoop-apm bucket line) so it can be reviewed or dropped independently.Trade-offs. Scoop stays documented because the
mainbucket entry is community-maintained but auto-updates from our releases with zero maintainer work.scoop update apmguidance elsewhere is unchanged and still correct.Issue and approved scope
Issue: none -- trivial documentation correction (broken link) found during the 2026-11-10 issue-reduction program (Atlas
documents/2026-11-10-issue-reduction-program.mdindanielmeppiel/apm-atlas, approved by Daniel Meppiel (@danielmeppiel)).Human scope-approval comment: trivial-documentation standing preapproval (broken links, per CONTRIBUTING.md and the issue templates).
Does this PR complete the issue, or what remains? Completes the fix across the docs site, the apm-usage guide and README (README commit pending maintainer review).
Type of change
Testing
Validation evidence:
curl -s -o /dev/null -w "%{http_code}" https://github.com/microsoft/scoop-apm404curl -s https://raw.githubusercontent.com/ScoopInstaller/Main/master/bucket/apm.json200,"version": "0.35.0", URLgithub.com/microsoft/apm/releases/...git grep -n scoop-apmafter changeLC_ALL=C grep -c '[^ -~]'on both changed files0(printable ASCII)No tests assert on these pages; the docs build was not run locally.
How to test. On Windows with Scoop:
scoop install apmthenapm --version.Spec conformance (OpenAPM v0.1)
docs/src/content/docs/specs/openapm-v0.1.mdupdated(new/changed
<a id="req-XXX"></a>anchor + prose + Appendix Crow).
docs/src/content/docs/specs/manifests/openapm-v0.1.requirements.ymlupdated.
@pytest.mark.req("req-XXX")test undertests/spec_conformance/added or extended.CONFORMANCE.{md,json}regenerated viauv run --extra dev python -m tests.spec_conformance.gen_statementand committed.