[docs] Update documentation for features from 2026-05-12#1286
Open
danielmeppiel wants to merge 1 commit into
Open
[docs] Update documentation for features from 2026-05-12#1286danielmeppiel wants to merge 1 commit into
danielmeppiel wants to merge 1 commit into
Conversation
- authentication.md: document full https:// ADO URL form (#1254) - policy-reference.md: clarify unmanaged_files provenance and inheritance omission semantics (#1253, #1256) - install-mcp-servers.md: note Cursor-native MCP schema (#1240) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
danielmeppiel
added
automation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the Starlight docs to reflect recent APM behavior changes around Azure DevOps dependency URL parsing, policy inheritance semantics for unmanaged_files, unmanaged-file provenance, and Cursor MCP config schema details.
Changes:
- Document that Azure DevOps dependencies accept both shorthand (
dev.azure.com/...) and fullhttps://dev.azure.com/...URL forms, including sub-path installs. - Clarify unmanaged-files governance semantics (what counts as managed/tracked) and how
unmanaged_files.actionbehaves under policy inheritance when omitted by a child policy. - Note that Cursor uses a Cursor-native MCP server schema (
type: stdio/type: http) in.cursor/mcp.json.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/docs/getting-started/authentication.md | Updates ADO authentication/install examples to include full https:// URL forms. |
| docs/src/content/docs/enterprise/policy-reference.md | Clarifies unmanaged-files provenance and inheritance behavior for unmanaged_files.action. |
| docs/src/content/docs/consumer/install-mcp-servers.md | Adds a note that Cursor’s MCP config uses Cursor-native type values. |
Copilot's findings
- Files reviewed: 3/3 changed files
- Comments generated: 2
|
|
||
| Detect files in governance directories that are not tracked by APM. | ||
|
|
||
| A file is "tracked by APM" only if it was produced by an installed plugin. Pre-existing files that APM did not deploy are counted as unmanaged even if they reside in a governed directory. |
| ```bash | ||
| apm install dev.azure.com/myorg/myproject/myrepo#main | ||
| apm install https://dev.azure.com/myorg/myproject/_git/myrepo # full URL also accepted | ||
| apm install mycompany.visualstudio.com/org/project/repo # legacy URL |
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.
Documentation Updates - 2026-05-12
This PR updates documentation based on fixes merged in the last 24 hours.
Features Documented
https://ADO URL support (from fix: accept full ADO https:// URLs with sub-paths (closes #1128) #1254)unmanaged_filespreserves parent value (from fix: policy inheritance preserves parent unmanaged_files when child omits block (closes #1198) #1253)apm installfile provenance: only APM-produced files are tracked as managed (from fix: apm install no longer adopts files not produced by installed plugins (closes #1199) #1256)type: stdio/type: http) (from fix: emit Cursor-native MCP schema (type: stdio) instead of Copilot schema #1240)Changes Made
docs/src/content/docs/getting-started/authentication.mdto document that full `(dev.azure.com/redacted) URLs are accepted in addition to the shorthand form, with examples for both standard and sub-path installs.docs/src/content/docs/enterprise/policy-reference.md:unmanaged_files.actioninheritance: omitting the block in a child policy is "no opinion" and preserves the parent value unchanged.docs/src/content/docs/consumer/install-mcp-servers.mdto note that Cursor's MCP config uses Cursor-native schema (type: stdio/type: http).Merged PRs Referenced