diff --git a/docs/csharp/specification/overview.md b/docs/csharp/specification/overview.md index 58164369cfa94..5cd991f49d039 100644 --- a/docs/csharp/specification/overview.md +++ b/docs/csharp/specification/overview.md @@ -9,6 +9,10 @@ The [C# language specification](~/_csharpstandard/standard/README.md) is the def 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. -Because the committee has fallen behind the latest implementation, this section also contains the [Microsoft specifications](~/_csharplang/proposals/csharp-8.0/nullable-reference-types.md) for those newer features that haven't been incorporated into the standard yet. You can read those 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 was to guide the design and implementation of the feature. They may include proposed features that haven't yet been implemented. The actual implementation may have been modified while implementing the feature. Those changes are captured in the 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. +## Feature specifications + +Because the committee has fallen behind the latest implementation, this section also contains the [Microsoft specifications](~/_csharplang/proposals/csharp-8.0/nullable-reference-types.md) for those newer features that haven't been incorporated into the standard yet. You can read those 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. 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. diff --git a/docs/csharp/specification/toc.yml b/docs/csharp/specification/toc.yml index 510c510b062d7..4868e3f8e00ee 100644 --- a/docs/csharp/specification/toc.yml +++ b/docs/csharp/specification/toc.yml @@ -1,8 +1,7 @@ items: - name: C# specifications + href: index.yml items: - - name: Index - href: index.yml - name: Overview href: overview.md - name: C# 8 draft specification