From 919a02ef6f8bd31d1d471c579a5f570f38afced3 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Thu, 5 Feb 2026 15:14:54 -0500 Subject: [PATCH 1/2] Clarify version alignment Fixes #50685 Quick edit pass as well. --- docs/csharp/specification/overview.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/csharp/specification/overview.md b/docs/csharp/specification/overview.md index bb9e72f3204f3..ae2c87c0eb2f7 100644 --- a/docs/csharp/specification/overview.md +++ b/docs/csharp/specification/overview.md @@ -1,16 +1,18 @@ --- title: "Standard specification" description: "Understand the relationships among the ECMA C# standard and the working draft." -ms.date: 05/08/2024 +ms.date: 02/05/2026 --- # C# standard specification -The [C# language specification](~/_csharpstandard/standard/README.md) is the definitive source for the C# language. The [ECMA C# standard committee (TC49-TG2)](https://www.ecma-international.org/task-groups/tc49-tg2/) produces the specification. The committee is currently working on version 8 of the standard. The draft published here includes some, but not all, of the C# 8 features. The committee uses [Microsoft specifications](https://github.com/dotnet/csharplang/tree/main/proposals) and [language design meeting (LDM) notes](https://github.com/dotnet/csharplang/tree/main/meetings) to produce the specification. +The [C# language specification](~/_csharpstandard/standard/README.md) is the authoritative source for the C# language. The [ECMA C# standard committee (TC49-TG2)](https://www.ecma-international.org/task-groups/tc49-tg2/) produces the specification. The standard document versions align with the C# language versions. The C# 8 standard corresponds to C# 8.0. + +The committee is currently working on version 8 of the standard. The draft published here is a feature complete draft of C# 8. The committee uses [Microsoft specifications](https://github.com/dotnet/csharplang/tree/main/proposals) and [language design meeting (LDM) notes](https://github.com/dotnet/csharplang/tree/main/meetings) to produce the specification. This section contains the latest working draft of the [C# language specification](~/_csharpstandard/standard/README.md). The latest working draft is published here before being submitted to ECMA for approval. The committee works in the [dotnet/csharpstandard](https://github.com/dotnet/csharpstandard) repository. You can track the committee's progress and participate in the standard work there. > [!NOTE] -> The committee works to update the C# language specification, but it has fallen behind the current implementation. For specifications about current features, see [Feature specifications](feature-spec-overview.md). +> The committee works to update the C# language specification, but it fell behind the current implementation. For specifications about current features, see [Feature specifications](feature-spec-overview.md). ## See also From cf1c1584800b2a6947daa9a1552be171d61b70fd Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Thu, 5 Feb 2026 15:35:49 -0500 Subject: [PATCH 2/2] respond to copilot feedback --- docs/csharp/specification/feature-spec-overview.md | 8 ++++---- docs/csharp/specification/overview.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/csharp/specification/feature-spec-overview.md b/docs/csharp/specification/feature-spec-overview.md index 07a79d999dd6c..e774bec7d7372 100644 --- a/docs/csharp/specification/feature-spec-overview.md +++ b/docs/csharp/specification/feature-spec-overview.md @@ -1,15 +1,15 @@ --- title: "Feature specifications" description: "Understand the relationships among the ECMA C# standard and the feature specifications for newer language features implemented in roslyn." -ms.date: 05/08/2024 +ms.date: 02/06/2026 --- # Feature specifications -Because the [C# standard specification](overview.md) has fallen behind the latest C# implementation, this section contains the [Microsoft specifications](~/_csharplang/proposals/csharp-10.0/enhanced-line-directives.md) for those newer features that haven't yet been incorporated into the standard. You can read these specifications to get information on newer features. +Because the [C# standard specification](overview.md) fell behind the latest C# implementation, this section contains the [Microsoft specifications](~/_csharplang/proposals/csharp-10.0/enhanced-line-directives.md) for those newer features that aren't yet incorporated into the standard. You can read these specifications to get information on newer features. -The feature specifications began as proposals for the design. They include proposed changes to the standard. The C# language design team and compiler team produce these feature specifications. The purpose of the proposals is to guide the design and implementation of the feature. They might include proposed features that haven't yet been implemented. The actual implementation might have modified behavior. Those changes are captured in the language design meeting (LDM) notes. The LDM notes are the minutes of the language design meetings. In most cases, the pertinent LDM notes are linked from the feature specifications. +The feature specifications began as proposals for the design. They include proposed changes to the standard. The C# language design team and compiler team produce these feature specifications. The purpose of the proposals is to guide the design and implementation of the feature. They might include proposed features that aren't yet implemented. The actual implementation might have modified behavior. The language design meeting (LDM) notes capture those changes. The LDM notes are the minutes of the language design meetings. In most cases, the pertinent LDM notes are linked from the feature specifications. -As the committee works on newer versions, the feature specifications are removed from this site, and those links are redirected to the updated sections of the standard. In the meantime, the feature specifications represent the best information on those features. +As the committee works on newer versions, the standard replaces the feature specifications. In the meantime, the feature specifications represent the best information on those features. ## See also diff --git a/docs/csharp/specification/overview.md b/docs/csharp/specification/overview.md index ae2c87c0eb2f7..d743d3d1dec46 100644 --- a/docs/csharp/specification/overview.md +++ b/docs/csharp/specification/overview.md @@ -5,7 +5,7 @@ ms.date: 02/05/2026 --- # C# standard specification -The [C# language specification](~/_csharpstandard/standard/README.md) is the authoritative source for the C# language. The [ECMA C# standard committee (TC49-TG2)](https://www.ecma-international.org/task-groups/tc49-tg2/) produces the specification. The standard document versions align with the C# language versions. The C# 8 standard corresponds to C# 8.0. +The [C# language specification](~/_csharpstandard/standard/README.md) is the definitive source for the C# language. The [ECMA C# standard committee (TC49-TG2)](https://www.ecma-international.org/task-groups/tc49-tg2/) produces the specification. The standard document versions align with the C# language versions. The C# 8 standard corresponds to C# 8.0. The committee is currently working on version 8 of the standard. The draft published here is a feature complete draft of C# 8. The committee uses [Microsoft specifications](https://github.com/dotnet/csharplang/tree/main/proposals) and [language design meeting (LDM) notes](https://github.com/dotnet/csharplang/tree/main/meetings) to produce the specification.