Skip to content

Add introductory guide to .NET source-build - #5618

Merged
mthalman merged 2 commits into
dotnet:mainfrom
mthalman:mthalman-source-build-crash-course
Jul 27, 2026
Merged

Add introductory guide to .NET source-build#5618
mthalman merged 2 commits into
dotnet:mainfrom
mthalman:mthalman-source-build-crash-course

Conversation

@mthalman

Copy link
Copy Markdown
Member

Summary

.NET engineers need a consolidated introduction to the source-build philosophy and the downstream constraints it protects. This adds a teaching-oriented guide that explains why source-build exists before introducing its implementation details.

The guide covers:

  • source-build users, goals, and downstream guarantees;
  • the VMR build lifecycle and dependency provenance;
  • repository ordering and package-version lifting;
  • prebuilt detection, poisoning, and binary policy;
  • sequential and two-stage bootstrap workflows; and
  • source-build validation and CI dimensions.

The documentation index now links to the new guide.

Validation

  • Verified local Markdown files and heading anchors resolve.
  • Verified reference-style links are defined and used.
  • Checked the documentation diff for formatting errors.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 90e5bd72-0b40-4e76-b4e7-786378cbd0c7
@mthalman
mthalman marked this pull request as ready for review July 22, 2026 20:10
@mthalman
mthalman requested a review from a team as a code owner July 22, 2026 20:10
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 90e5bd72-0b40-4e76-b4e7-786378cbd0c7

@ellahathaway ellahathaway left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@mthalman
mthalman merged commit a176dcd into dotnet:main Jul 27, 2026
3 checks passed
@mthalman
mthalman deleted the mthalman-source-build-crash-course branch July 27, 2026 21:22
@mthalman

Copy link
Copy Markdown
Member Author

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