Skip to content

Conversation

@fuguiKz
Copy link

@fuguiKz fuguiKz commented Dec 27, 2025

The AssemblySearchPaths section currently says “ten locations … (four if you use the .NET SDK)” but doesn’t specify which four.

This change:

  • Adds a short explanation that AssemblySearchPaths is a semicolon-delimited list of placeholders.
  • Lists the default search path order for non-SDK-style projects (numbered list).
  • Explicitly lists the 4 default placeholders used by SDK-style projects.

Related: dotnet/msbuild#12949

@prmerger-automator
Copy link
Contributor

@fuguiKz : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 238e69b:

✅ Validation status: passed

File Status Preview URL Details
docs/msbuild/troubleshoot-assembly-references.md ✅Succeeded

For more details, please refer to the build report.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2937bf4:

✅ Validation status: passed

File Status Preview URL Details
docs/msbuild/troubleshoot-assembly-references.md ✅Succeeded

For more details, please refer to the build report.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the MSBuild documentation by clarifying the default AssemblySearchPaths configuration, specifically addressing the difference between SDK-style and non-SDK-style projects.

Key changes:

  • Explicitly lists all 10 default search paths for non-SDK-style projects in a numbered list
  • Specifies the 4 default search paths used by SDK-style projects
  • Adds explanation that AssemblySearchPaths is a semicolon-delimited list of placeholders that expand during resolution
  • Provides guidance on how to inspect the effective search paths using MSBuild tooling

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@v-regandowner
Copy link
Contributor

@ghogen

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Dec 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants