Repository navigation
docs: re-sweep pages freed by the v0.36.1 release - #3831
Merged
Merged
Conversation
After v0.36.1 the 0.36.1 PRs that edited these pages have landed. Re-verified the sweep's recorded findings and the new 0.36.1 behavior (COPILOT_HOME/CODEX_HOME user roots, OpenCode LSP, remote MCP shapes, name@X.Y.Z pinning) against main and fixed what still drifts. Refs #3800 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 18, 2026 06:48
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
No active review issues block the documentation-only updates describing current APM behavior.
No open issues 🎉
What changed in this PR
This docs-only PR continues #3800’s post-v0.36.1 re-sweep, updating five pages to reflect current APM behavior. It covers pages no longer being edited by open PRs and makes no runtime changes.
Changes:
- Clarifies policy discovery, status output, and accepted dependency identifiers.
- Corrects MCP command syntax, configuration-write conditions, and re-add behavior.
- Documents saved install target precedence, LSP target gating, and
$CODEX_HOMEdetection.
| File | Description |
|---|---|
docs/src/content/docs/reference/targets-matrix.md |
Adds saved install target precedence and clarifies LSP target gating. |
docs/src/content/docs/reference/environment-variables.md |
Corrects user-scope detection to honor $CODEX_HOME. |
docs/src/content/docs/consumer/manage-dependencies.md |
Corrects identifier formats accepted by apm deps why. |
docs/src/content/docs/consumer/install-mcp-servers.md |
Updates MCP forms, command syntax, Claude write conditions, and re-add behavior; removes a stale source-line reference. |
docs/src/content/docs/consumer/governance-on-the-consumer-ramp.md |
Expands policy discovery locations, links the full field reference, and adds status warnings. |
Review effort: Balanced
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
Phase 2 of the docs re-sweep, run after v0.36.1 was tagged. Five pages that 0.36.1 PRs edited are no longer touched by any open PR. I re-verified the recorded findings and the new 0.36.1 behavior against current main, and these fixes target main for 0.37.
consumer/governance-on-the-consumer-ramp.md: policy auto-discovery checks.github-private,.github,.apmand then_apm; the page named only.github. ADO and GitLab now link to "Where it lives". The field list is the main fields, not all of them. Theapm policy statussample gets itsWarningsrow. The target values are examples.consumer/install-mcp-servers.md:apm config targetis nowapm config set target. A no-op re-add logsalready declared; checking integrations, notunchanged. "Three forms" becomes "Four forms" to match the listed examples. The Claude project.mcp.jsonis written only if.claude/exists. Dropped a stalecopilot.pyline number.consumer/manage-dependencies.md:apm deps whymatches the unique key (owner/repo, orhost/owner/repofor non-GitHub) or the lockfilerepo_url, notowner_repoor an https URL.reference/environment-variables.md: user-scope auto-detection checks$CODEX_HOMEwhen it is set (after fix(targets): one owner for harness user roots; honor COPILOT_HOME (#3745) #3782).reference/targets-matrix.md: install target resolution includes the savedapm config set targetdefault (compile does not use it). LSP follows the same gate, for claude/copilot/opencode.consumer/install-lsp-servers.mdwas re-checked after the OpenCode LSP and COPILOT_HOME changes and has no drift.Issue and approved scope
Issue: Refs #3800
Human scope-approval comment: #3800 (comment)
Does this PR complete the issue, or what remains? Partial: post-v0.36.1 phase-2 batch. Pages still edited by open PRs stay out of scope and are listed in the final sweep report.
Type of change
Testing
.venv/bin/apm <cmd> --help, the source undersrc/apm_cli/, or a scratch-directory run.cd docs && npm run buildexits 0 ("All internal links are valid"; "Checked 1209 relative link(s) ... No broken relative links found").Spec conformance (OpenAPM v0.1)