Skip to content

docs: re-sweep pages freed by the v0.36.1 release - #3831

Merged
Daniel Meppiel (danielmeppiel) merged 1 commit into
mainfrom
docs-sweep/phase2b
Nov 18, 2026
Merged

Daniel Meppiel (danielmeppiel) merged 1 commit into
mainfrom
docs-sweep/phase2b

Conversation

@danielmeppiel

Copy link
Copy Markdown
Collaborator

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, .apm and 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. The apm policy status sample gets its Warnings row. The target values are examples.
  • consumer/install-mcp-servers.md: apm config target is now apm config set target. A no-op re-add logs already declared; checking integrations, not unchanged. "Three forms" becomes "Four forms" to match the listed examples. The Claude project .mcp.json is written only if .claude/ exists. Dropped a stale copilot.py line number.
  • consumer/manage-dependencies.md: apm deps why matches the unique key (owner/repo, or host/owner/repo for non-GitHub) or the lockfile repo_url, not owner_repo or an https URL.
  • reference/environment-variables.md: user-scope auto-detection checks $CODEX_HOME when 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 saved apm config set target default (compile does not use it). LSP follows the same gate, for claude/copilot/opencode.

consumer/install-lsp-servers.md was 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

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

Testing

  • Tested locally: every changed claim was verified against .venv/bin/apm <cmd> --help, the source under src/apm_cli/, or a scratch-directory run. cd docs && npm run build exits 0 ("All internal links are valid"; "Checked 1209 relative link(s) ... No broken relative links found").
  • All existing tests pass (docs-only change)
  • Added tests for new functionality (if applicable)

Spec conformance (OpenAPM v0.1)

  • N/A -- this PR does not change OpenAPM-observable behaviour.

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>

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 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_HOME detection.
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

@danielmeppiel
Daniel Meppiel (danielmeppiel) merged commit 62c66ec into main Nov 18, 2026
26 checks passed
@danielmeppiel
Daniel Meppiel (danielmeppiel) deleted the docs-sweep/phase2b branch November 18, 2026 07:07
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