Refactor more language agnostic content into includes #49651
Merged
Conversation
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
alexwolfmsft
requested review from
a team,
JonathanCrd,
christothes,
jsquire and
scottaddie
as code owners
Contributor
There was a problem hiding this comment.
Pull Request Overview
This pull request refactors documentation content by extracting common authentication documentation into reusable include files. The main purpose is to reduce duplication and improve maintainability by consolidating shared content that appears across multiple documentation pages.
Key changes:
- Created new include files for authentication-related content (Visual Studio Code, Azure CLI, Azure Developer CLI, Azure PowerShell, broker configuration, and overview content).
- Replaced duplicate content in existing documentation files with include references.
- Consolidated the main overview content from
index.mdinto a reusable include file.
Reviewed Changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| docs/azure/sdk/includes/overview.md | New include file containing the main authentication overview content previously in index.md |
| docs/azure/sdk/includes/overview-broker.md | New include file for broker authentication overview section |
| docs/azure/sdk/includes/broker-configure-app.md | New include file for broker app configuration instructions |
| docs/azure/sdk/includes/broker-assign-roles.md | New include file for broker role assignment instructions |
| docs/azure/sdk/includes/auth-visual-studio-code.md | New include file for Visual Studio Code authentication instructions |
| docs/azure/sdk/includes/auth-azure-powershell.md | New include file for Azure PowerShell authentication instructions |
| docs/azure/sdk/includes/auth-azure-developer-cli.md | New include file for Azure Developer CLI authentication instructions |
| docs/azure/sdk/includes/auth-azure-cli.md | New include file for Azure CLI authentication instructions |
| docs/azure/sdk/authentication/local-development-dev-accounts.md | Replaced inline content with include references for authentication tools |
| docs/azure/sdk/authentication/local-development-broker.md | Replaced inline content with include references for broker configuration and role assignment |
| docs/azure/sdk/authentication/index.md | Replaced main content with include references |
alexwolfmsft
commented
Nov 7, 2025
alexwolfmsft
commented
Nov 7, 2025
alexwolfmsft
commented
Nov 7, 2025
scottaddie
reviewed
Nov 7, 2025
Co-authored-by: Scott Addie <[email protected]>
gewarren
approved these changes
Nov 7, 2025
Co-authored-by: Genevieve Warren <[email protected]>
scottaddie
approved these changes
Nov 7, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
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.
Summary
Internal previews