Skip to content

Link to the correct source of truth#54819

Open
BillWagner wants to merge 1 commit into
dotnet:mainfrom
BillWagner:fix-version-discrepancies
Open

Link to the correct source of truth#54819
BillWagner wants to merge 1 commit into
dotnet:mainfrom
BillWagner:fix-version-discrepancies

Conversation

@BillWagner

@BillWagner BillWagner commented Jul 16, 2026

Copy link
Copy Markdown
Member

Fixes #54088

The tables incorporated had diverged from the official Windows versions. Instead of continuing to chase them, link to the Windows docs.


Internal previews

📄 File 🔗 Preview link
docs/csharp/language-reference/compiler-options/advanced.md Advanced C# compiler options
docs/visual-basic/reference/command-line-compiler/subsystemversion.md "-subsystemversion"

Fixes dotnet#54088

The tables incorporated had diverged from the official Windows versions. Instead of continuing to chase them, link to the Windows docs.
Copilot AI review requested due to automatic review settings July 16, 2026 20:52
@BillWagner
BillWagner requested a review from a team as a code owner July 16, 2026 20:52
@dotnetrepoman dotnetrepoman Bot added this to the July 2026 milestone Jul 16, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the Visual Basic and C# compiler option documentation for SubsystemVersion to avoid maintaining potentially divergent Windows version tables by linking to the Windows “Operating System Version” documentation instead.

Changes:

  • Removed the Windows version-to-subsystem version tables from the C# and Visual Basic docs.
  • Added a link to the Windows “Operating System Version” page as the source of truth.
  • Updated ms.date metadata in both articles.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/visual-basic/reference/command-line-compiler/subsystemversion.md Removes the embedded subsystem version table and links to Windows documentation instead.
docs/csharp/language-reference/compiler-options/advanced.md Removes the embedded subsystem version table and links to Windows documentation instead.

```

The `major.minor` specify the minimum required version of the subsystem, as expressed in a dot notation for major and minor versions. For example, you can specify that an application can't run on an operating system that's older than Windows 7. Set the value of this option to 6.01, as the table later in this article describes. You specify the values for `major` and `minor` as integers. Leading zeroes in the `minor` version don't change the version, but trailing zeroes do. For example, 6.1 and 6.01 refer to the same version, but 6.10 refers to a different version. We recommend expressing the minor version as two digits to avoid confusion.
The `major.minor` specify the minimum required version of the subsystem, as expressed in a dot notation for major and minor versions. For example, you can specify that an application can't run on an operating system that's older than Windows 7. Set the value of this option to 6.01. You specify the values for `major` and `minor` as integers. Leading zeroes in the `minor` version don't change the version, but trailing zeroes do. For example, 6.1 and 6.01 refer to the same version, but 6.10 refers to a different version. We recommend expressing the minor version as two digits to avoid confusion.
Comment on lines +28 to 30
The minimum required version of the subsystem, as expressed in a dot notation for major and minor versions. For example, you can specify that an application can't run on an operating system that's older than Windows 7 if you set the value of this option to 6.01. You must specify the values for `major` and `minor` as integers.

Leading zeroes in the `minor` version don't change the version, but trailing zeroes do. For example, 6.1 and 6.01 refer to the same version, but 6.10 refers to a different version. We recommend expressing the minor version as two digits to avoid confusion.
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.

Discrepancies in SubsystemVersion table compared to OS Version doc

2 participants