Skip to content

docs: install APM from Scoop's default main bucket (dead scoop-apm link) - #3517

Merged
Daniel Meppiel (danielmeppiel) merged 2 commits into
mainfrom
lane-a/docs-scoop-main-bucket
Nov 11, 2026
Merged

Daniel Meppiel (danielmeppiel) merged 2 commits into
mainfrom
lane-a/docs-scoop-main-bucket

Conversation

@danielmeppiel

@danielmeppiel Daniel Meppiel (danielmeppiel) commented Nov 10, 2026 •

Copy link
Copy Markdown
Collaborator

Description

TL;DR: The documented Scoop bucket https://github.com/microsoft/scoop-apm returns 404. APM already ships in Scoop's default main bucket, so the install instructions now just say scoop install apm.

Problem (WHY). scoop bucket add apm https://github.com/microsoft/scoop-apm fails (repo does not exist), so Windows users following the docs hit an error before scoop install apm.

Approach (WHAT). Drop the dead scoop bucket add line. APM is published in ScoopInstaller/Main bucket/apm.json (version 0.35.0, checkver/autoupdate from microsoft/apm GitHub releases), and main is added to every Scoop install by default.

Implementation (HOW).

File Change
docs/src/content/docs/getting-started/installation.md Scoop section: remove bucket add, note the default main bucket
packages/apm-guide/.apm/skills/apm-usage/installation.md Same correction in the apm-usage skill (not deployed into this repo; no lockfile hash change)
README.md Separate commit, needs Daniel Meppiel (@danielmeppiel)'s explicit review: drop the same dead scoop bucket add line

Important

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 main bucket entry is community-maintained but auto-updates from our releases with zero maintainer work. scoop update apm guidance 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.md in danielmeppiel/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

  • Bug fix
  • New feature
  • Documentation
  • Maintenance / refactor

Testing

  • Tested locally
  • All existing tests pass
  • Added tests for new functionality (if applicable)

Validation evidence:

Check Result
curl -s -o /dev/null -w "%{http_code}" https://github.com/microsoft/scoop-apm 404
curl -s https://raw.githubusercontent.com/ScoopInstaller/Main/master/bucket/apm.json 200, "version": "0.35.0", URL github.com/microsoft/apm/releases/...
git grep -n scoop-apm after change no matches
LC_ALL=C grep -c '[^ -~]' on both changed files 0 (printable ASCII)

No tests assert on these pages; the docs build was not run locally.

How to test. On Windows with Scoop: scoop install apm then apm --version.

Spec conformance (OpenAPM v0.1)

  • Spec edit: docs/src/content/docs/specs/openapm-v0.1.md updated
    (new/changed <a id="req-XXX"></a> anchor + prose + Appendix C
    row).
  • Manifest edit: docs/src/content/docs/specs/manifests/openapm-v0.1.requirements.yml
    updated.
  • Test edit: a @pytest.mark.req("req-XXX") test under
    tests/spec_conformance/ added or extended.
  • CONFORMANCE.{md,json} regenerated via
    uv run --extra dev python -m tests.spec_conformance.gen_statement
    and committed.
  • N/A -- this PR does not change OpenAPM-observable behaviour.

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>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

ðŸŸĒ 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 main bucket using scoop 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>
@danielmeppiel
Daniel Meppiel (danielmeppiel) merged commit c79f14b into main Nov 11, 2026
27 checks passed
@danielmeppiel
Daniel Meppiel (danielmeppiel) deleted the lane-a/docs-scoop-main-bucket branch November 11, 2026 12:55
This was referenced Nov 11, 2026
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