Supported documentation
Reliable X-ray vision begins with transparent, testable mappings to public source repositories.
Reviewed direct mappings
Microsoft Docs X-Ray keeps ordered mappings for common product areas, including the docsets in MicrosoftDocs/defender-docs and the current Aspire docs at aspire.dev. Narrow routes such as Defender for Cloud, Microsoft Sentinel, Microsoft Graph API versions, and Fabric get-started pages are matched before broader product routes.
MicrosoftDocs organization coverage
For any other Microsoft Learn article whose public Edit source points to a repository in the MicrosoftDocs organization, Docs X-Ray resolves the exact repository, branch, and file path from Learn’s published metadata. This covers active and archived repositories without guessing from a repository name, and newly published MicrosoftDocs sources do not require a site release.
How URL mapping works
For Microsoft Learn, a leading locale such as en-us or fr-fr is removed for direct repository lookup. The configured site prefix is replaced with a repository path prefix, and the article slug becomes a Markdown or MDX filename.
For example, /en-us/entra/identity/conditional-access/overview maps to docs/identity/conditional-access/overview.md in MicrosoftDocs/entra-docs. The Aspire page aspire.dev/get-started/what-is-aspire/ maps to src/frontend/src/content/docs/get-started/what-is-aspire.mdx in microsoft/aspire.dev.
Microsoft Intune supports both the current /intune/… URLs and legacy /mem/intune/… URLs; both map to the same intune/… source tree in MicrosoftDocs/memdocs.
Query-specific mappings are supported. Microsoft Graph’s ?view=graph-rest-beta selects the beta API source tree, while graph-rest-1.0 selects v1.0. Unmatched MicrosoftDocs pages use the source metadata lookup described above.
Limitations
- Some documentation pages are generated, private, moved, or sourced through nonstandard publishing pipelines.
- A public URL does not always have a one-to-one public Markdown or MDX file.
- Docs X-Ray compares Git revisions, not changes introduced by runtime site rendering or personalization.
- Repository moves can temporarily break a mapping until the configuration is updated.
Unsupported paths fail explicitly and link back to the original documentation page. To request a mapping, open an issue with an example URL.