Publish standard (#27795)

* Use ECMA spec

Contributes to #27789

Change the published spec from the Microsoft C# 6 draft to the ECMA C# 6 draft.

* Update links

First commit of link updates. This doesn't update all anchors.

* fix all links with anchors

The standard contains clause numbers, which changes the anchor text for all anchor links. Update those.

* fix warnings.

* fix warning

Adding the C# standard created duplicate H1s. Fix this one.

Author: BillWagner

.gitignore

@@ -13,6 +13,7 @@ api/
 _themes/
 _themes.pdf/
 _csharplang/
+_csharpstandard/
 _vblang/
 log/
 .optemp/

.openpublishing.publish.config.json

@@ -51,6 +51,12 @@
       "branch": "main",
       "include_in_build": true
     },
+    {
+      "path_to_root": "_csharpstandard",
+      "url": "https://github.com/dotnet/csharpstandard",
+      "branch": "draft-v6",
+      "include_in_build": true
+    },
     {
       "path_to_root": "_vblang",
       "url": "https://github.com/dotnet/vblang",

.repoman.yml

@@ -105,6 +105,11 @@ pull_request:
               run:
                 - labels-add: ["dotnet-csharp/prod", "csharp-spec/tech"]
 
+            # csharpstandard
+            - path: "(?i).*_csharpstandard.*"
+              run:
+                - labels-add: ["dotnet-csharp/prod", "csharp-spec/tech"]
+
             # vbspec
             - path: "(?i).*_vblang\/spec.*"
               run:

docfx.json

@@ -26,12 +26,8 @@
         "files": [
           "**/*.md"
         ],
-        "src": "_csharplang/spec",
-        "dest": "csharp/language-reference/language-specification",
-        "exclude": [
-          "README.md",
-          "LICENSE.md"
-        ]
+        "src": "_csharpstandard/standard",
+        "dest": "csharp/language-reference/language-specification"
       },
       {
         "files": [
@@ -180,6 +176,7 @@
       },
       "ms.prod": {
         "_csharplang/**/*.md": "dotnet-csharp",
+        "_csharpstandard/**/*.md": "dotnet-csharp",
         "_vblang/spec/*.md": "dotnet-visualbasic",
         "docs/architecture/**/**.md": "dotnet-architecture",
         "docs/azure/**/*.*": "dotnet-azure",
@@ -199,6 +196,7 @@
       },
       "ms.topic": {
         "_csharplang/**/*.md": "language-reference",
+        "_csharpstandard/**/*.md": "language-reference",
         "_vblang/spec/*.md": "language-reference",
         "docs/azure/**/**.md": "conceptual",
         "docs/core/compatibility/**.md": "reference",
@@ -348,6 +346,7 @@
       },
       "ms.author": {
           "_csharplang/**/*.md": "wiwagn",
+          "_csharpstandard/**/*.md": "wiwagn",
           "_vblang/spec/*.md": "wiwagn",
           "docs/architecture/**/**.md": "nanil",
           "docs/architecture/grpc-for-wcf-developers/**/**.md": "jamesnk",
@@ -432,7 +431,7 @@
           "docs/visual-basic/**/**.md": "kdollard"
       },
       "ms.date": {
-        "_csharplang/spec/*.md": "07/01/2017",
+        "_csharpstandard/standard/*.md": "01/10/2021",
         "_csharplang/proposals/csharp-7.0/*.md": "08/13/2018",
         "_csharplang/proposals/csharp-7.1/*.md": "02/16/2018",
         "_csharplang/proposals/csharp-7.2/*.md": "01/19/2019",
@@ -444,6 +443,7 @@
       },
       "ms.technology": {
         "_csharplang/**/*.md": "csharp-spec",
+        "_csharpstandard/**/*.md": "csharp-spec",
         "_vblang/spec/*.md": "vb-spec",
         "docs/architecture/blazor-for-web-forms-developers/**/**.md": "blazor",
         "docs/architecture/cloud-native/**/**.md": "cloud-native",
@@ -508,6 +508,7 @@
       },
       "recommendations": {
         "_csharplang/**/*.md": false,
+        "_csharpstandard/**/*.md": false,
         "_vblang/spec/*.md": false,
         "docs/architecture/**/**.md": false,
         "docs/standard/design-guidelines/**/**.md": false,
@@ -544,25 +545,37 @@
         "docs/whats-new/**/**.md": false
       },
       "title": {
-        "_csharplang/spec/introduction.md": "Introduction",
-        "_csharplang/spec/lexical-structure.md": "Lexical structure",
-        "_csharplang/spec/basic-concepts.md": "Basic concepts",
-        "_csharplang/spec/types.md": "Types",
-        "_csharplang/spec/variables.md": "Variables",
-        "_csharplang/spec/conversions.md": "Conversions",
-        "_csharplang/spec/expressions.md": "Expressions",
-        "_csharplang/spec/statements.md": "Statements",
-        "_csharplang/spec/namespaces.md": "Namespaces",
-        "_csharplang/spec/classes.md": "Classes",
-        "_csharplang/spec/structs.md": "Structs",
-        "_csharplang/spec/arrays.md": "Arrays",
-        "_csharplang/spec/interfaces.md": "Interfaces",
-        "_csharplang/spec/enums.md": "Enums",
-        "_csharplang/spec/delegates.md": "Delegates",
-        "_csharplang/spec/exceptions.md": "Exceptions",
-        "_csharplang/spec/attributes.md": "Attributes",
-        "_csharplang/spec/unsafe-code.md": "Unsafe code",
-        "_csharplang/spec/documentation-comments.md": "Documentation comments",
+        "_csharpstandard/standard/README.md": "Table of contents",
+        "_csharpstandard/standard/foreword.md": "Foreword",
+        "_csharpstandard/standard/introduction.md": "Introduction",
+        "_csharpstandard/standard/scope.md": "Scope",
+        "_csharpstandard/standard/normative-references.md": "Normative references",
+        "_csharpstandard/standard/terms-and-definitions.md": "Terms and definitions",
+        "_csharpstandard/standard/acronyms-and-abbreviations.md": "Acronyms and abbreviations",
+        "_csharpstandard/standard/general-description.md": "General description",
+        "_csharpstandard/standard/conformance.md": "Conformance",
+        "_csharpstandard/standard/lexical-structure.md": "Lexical structure",
+        "_csharpstandard/standard/basic-concepts.md": "Basic concepts",
+        "_csharpstandard/standard/types.md": "Types",
+        "_csharpstandard/standard/variables.md": "Variables",
+        "_csharpstandard/standard/conversions.md": "Conversions",
+        "_csharpstandard/standard/expressions.md": "Expressions",
+        "_csharpstandard/standard/statements.md": "Statements",
+        "_csharpstandard/standard/namespaces.md": "Namespaces",
+        "_csharpstandard/standard/classes.md": "Classes",
+        "_csharpstandard/standard/structs.md": "Structs",
+        "_csharpstandard/standard/arrays.md": "Arrays",
+        "_csharpstandard/standard/interfaces.md": "Interfaces",
+        "_csharpstandard/standard/enums.md": "Enums",
+        "_csharpstandard/standard/delegates.md": "Delegates",
+        "_csharpstandard/standard/exceptions.md": "Exceptions",
+        "_csharpstandard/standard/attributes.md": "Attributes",
+        "_csharpstandard/standard/unsafe-code.md": "Unsafe code",
+        "_csharpstandard/standard/grammar.md": "Grammar",
+        "_csharpstandard/standard/portability-issues.md": "Portability issues",
+        "_csharpstandard/standard/standard-library.md": "Standard library",
+        "_csharpstandard/standard/documentation-comments.md": "Documentation comments",
+        "_csharpstandard/standard/Bibliography.md": "Bibliography",
 
         "_csharplang/proposals/csharp-7.0/pattern-matching.md": "Pattern matching",
         "_csharplang/proposals/csharp-7.0/local-functions.md": "Local functions",
@@ -654,25 +667,37 @@
         "_vblang/spec/overload-resolution.md": "Overload resolution"
       },
       "description": {
-        "_csharplang/spec/introduction.md": "This introduction provides an overview of the C# language and its design goals. Note: This chapter has been removed from the official standard in version 5.",
-        "_csharplang/spec/lexical-structure.md": "This chapter explains the lexical grammar, and the syntactic grammar of the C# language.",
-        "_csharplang/spec/basic-concepts.md": "This chapter introduces the major building blocks of any C# program. Concepts such as assemblies, program start and completion, member access, garbage completion and execution order are defined.",
-        "_csharplang/spec/types.md": "This chapter defines value types, reference types, generic types and other program entities. Concepts such as assemblies, namespaces, classes, interfaces and structs are defined.",
-        "_csharplang/spec/variables.md": "This chapter covers variable categories, default values, definite assignment, and variable references.",
-        "_csharplang/spec/conversions.md": "This chapter covers the possible conversions from one type to another in C#. Builtin conversions, user defined conversions, implicit and explicit conversions are defined.",
-        "_csharplang/spec/expressions.md": "This chapter covers operators and expressions. Expressions form several groups, including primary expressions, unary operators, arithmetic operators, relational and type testing operators, and logical operators.",
-        "_csharplang/spec/statements.md": "This chapter covers statements in C#. Each statement is defined, as are statement blocks, statement reachability, and end points.",
-        "_csharplang/spec/namespaces.md": "This chapter defines namespaces, including how to declare them and how to use them.",
-        "_csharplang/spec/classes.md": "This chapter covers class declarations, including all member types that can be included in classes. This includes generic classes as well as non-generic classes.",
-        "_csharplang/spec/structs.md": "This chapter defines struct declarations. In many cases, the descriptions are defined using the differences between classes and structs.",
-        "_csharplang/spec/arrays.md": "This chapter defines arrays. It includes the rules for array variance, multi-dimensional arrays and jagged arrays.",
-        "_csharplang/spec/interfaces.md": "This chapter defines interfaces. This includes interface declarations, implementing interfaces, and explicit interface implementation.",
-        "_csharplang/spec/enums.md": "This chapter defines the enum types in C#. Enums create a set of named constants and are represented by an underlying integral set of values.",
-        "_csharplang/spec/delegates.md": "This chapter defines delegates, which are objects that hold type safe function pointers.",
-        "_csharplang/spec/exceptions.md": "This chapter defines exceptions. Exceptions are how errors are reported by C# programs. This chapter covers throwing exceptions, catching exceptions, and resource cleanup when exceptions are thrown.",
-        "_csharplang/spec/attributes.md": "This chapter covers attributes. Attributes are metadata types that can be applied to many program elements: classes, structs, assemblies, members, and arguments.",
-        "_csharplang/spec/unsafe-code.md": "This chapter describes elements of C# that are allowed in unsafe code blocks. These elements include pointers, fixed buffers and dynamic memory allocation.",
-        "_csharplang/spec/documentation-comments.md": "This appendix describes XML comments that are used to document your program.",
+        "_csharpstandard/standard/README.md": "This contains the detailed table of contents, listing each clause in the standard",
+        "_csharpstandard/standard/foreword.md": "Foreword for the C# draft standard",
+        "_csharpstandard/standard/introduction.md": "This introduction provides an overview of the C# language and its design goals. Note: This chapter has been removed from the official standard in version 5.",
+        "_csharpstandard/standard/scope.md": "This clause defines the scope of the C# language standard",
+        "_csharpstandard/standard/normative-references.md": "This clause defines the normative references referred to and cited by this standard. Portions of this standard are governed by these references",
+        "_csharpstandard/standard/terms-and-definitions.md": "This clause defines terms used in this standard",
+        "_csharpstandard/standard/acronyms-and-abbreviations.md": "This clause defines acronyms and abbreviations used in this standard",
+        "_csharpstandard/standard/general-description.md": "This clause defines the general description of the C# language standard",
+        "_csharpstandard/standard/conformance.md": "This clause defines the areas of conformance for this standard",
+        "_csharpstandard/standard/lexical-structure.md": "This chapter explains the lexical grammar, and the syntactic grammar of the C# language.",
+        "_csharpstandard/standard/basic-concepts.md": "This chapter introduces the major building blocks of any C# program. Concepts such as assemblies, program start and completion, member access, garbage completion and execution order are defined.",
+        "_csharpstandard/standard/types.md": "This chapter defines value types, reference types, generic types and other program entities. Concepts such as assemblies, namespaces, classes, interfaces and structs are defined.",
+        "_csharpstandard/standard/variables.md": "This chapter covers variable categories, default values, definite assignment, and variable references.",
+        "_csharpstandard/standard/conversions.md": "This chapter covers the possible conversions from one type to another in C#. Builtin conversions, user defined conversions, implicit and explicit conversions are defined.",
+        "_csharpstandard/standard/expressions.md": "This chapter covers operators and expressions. Expressions form several groups, including primary expressions, unary operators, arithmetic operators, relational and type testing operators, and logical operators.",
+        "_csharpstandard/standard/statements.md": "This chapter covers statements in C#. Each statement is defined, as are statement blocks, statement reachability, and end points.",
+        "_csharpstandard/standard/namespaces.md": "This chapter defines namespaces, including how to declare them and how to use them.",
+        "_csharpstandard/standard/classes.md": "This chapter covers class declarations, including all member types that can be included in classes. This includes generic classes as well as non-generic classes.",
+        "_csharpstandard/standard/structs.md": "This chapter defines struct declarations. In many cases, the descriptions are defined using the differences between classes and structs.",
+        "_csharpstandard/standard/arrays.md": "This chapter defines arrays. It includes the rules for array variance, multi-dimensional arrays and jagged arrays.",
+        "_csharpstandard/standard/interfaces.md": "This chapter defines interfaces. This includes interface declarations, implementing interfaces, and explicit interface implementation.",
+        "_csharpstandard/standard/enums.md": "This chapter defines the enum types in C#. Enums create a set of named constants and are represented by an underlying integral set of values.",
+        "_csharpstandard/standard/delegates.md": "This chapter defines delegates, which are objects that hold type safe function pointers.",
+        "_csharpstandard/standard/exceptions.md": "This chapter defines exceptions. Exceptions are how errors are reported by C# programs. This chapter covers throwing exceptions, catching exceptions, and resource cleanup when exceptions are thrown.",
+        "_csharpstandard/standard/attributes.md": "This chapter covers attributes. Attributes are metadata types that can be applied to many program elements: classes, structs, assemblies, members, and arguments.",
+        "_csharpstandard/standard/unsafe-code.md": "This chapter describes elements of C# that are allowed in unsafe code blocks. These elements include pointers, fixed buffers and dynamic memory allocation.",
+        "_csharpstandard/standard/grammar.md": "This appendix lists the complete ANTLR grammar for C#. It's comprised of extracted blocks from each of the other clauses.",
+        "_csharpstandard/standard/portability-issues.md": "This appendix lists information about implementation dependent behavior and situations resulting in undefined behavior.",
+        "_csharpstandard/standard/standard-library.md": "This appendix lists requirements of the standard library. The C# language relies on these types for some of its behavior.",
+        "_csharpstandard/standard/documentation-comments.md": "This appendix describes XML comments that are used to document your program.",
+        "_csharpstandard/standard/Bibliography.md": "This appendix lists external standards referenced in this specification.",
 
         "_csharplang/proposals/csharp-7.0/pattern-matching.md": "This feature specification describes the pattern matching featues added in C# 7.0. Note that future releases built on this initial set of features.",
         "_csharplang/proposals/csharp-7.0/local-functions.md": "This feature specification describes local functions, which are functions that are embedded in another method or function.",
@@ -764,7 +789,7 @@
         "_vblang/spec/overload-resolution.md": "This chapter describes the rules that govern overload resolution when multiple members have the same name."
       },
       "titleSuffix": {
-        "_csharplang/spec/*.md": "C# language specification",
+        "_csharpstandard/standard/*.md": "C# language specification",
         "_csharplang/proposals/csharp-7.0/*.md": "C# 7.0 draft specifications",
         "_csharplang/proposals/csharp-7.1/*.md": "C# 7.1 draft specifications",
         "_csharplang/proposals/csharp-7.2/*.md": "C# 7.2 draft specifications",

docs/architecture/dapr-for-net-developers/foreword.md

@@ -1,11 +1,11 @@
 ---
-title: Foreword
+title: Foreword - Dapr for .NET Developers
 description: A foreword to Dapr for .NET Developers by Mark Russinovich
 author: markrussinovich
 ms.date: 02/17/2021
 ---
 
-# Foreword
+# Foreword - Dapr for .NET Developers
 
 With the wave of cloud adoption well underway, there is a major shift happening towards “cloud native” development, often built with microservice-architectures. These microservices are both stateless and stateful, and run on the cloud and edge, embracing the diversity of languages and frameworks available today. This enterprise shift is driven by both the market forces of faster time to market, as well as the scale and efficiencies of building services for the cloud. Even before COVID-19, cloud adoption was accelerating for enterprises and developers were being asked to do even more to deliver on building these distributed system applications, and that has only accelerated since. Developers in enterprises seek to focus on business logic, while leaning on platforms to imbue their applications with scale, resiliency, maintainability, elasticity, and the other attributes of cloud-native architectures, which is why there is also shift towards serverless platforms that hide the underlying infrastructure. Developers should not be expected to become distributed systems experts. This is where Dapr steps in to help you, whether you are building on infrastructure such as Kubernetes, or on a serverless platform.
 

docs/csharp/fundamentals/coding-style/identifier-names.md

@@ -11,7 +11,7 @@ An **identifier** is the name you assign to a type (class, interface, struct, de
 - Identifiers may contain Unicode letter characters, decimal digit characters, Unicode connecting characters, Unicode combining characters, or Unicode formatting characters. For more information on Unicode categories, see the [Unicode Category Database](https://www.unicode.org/reports/tr44/).
 You can declare identifiers that match C# keywords by using the `@` prefix on the identifier. The `@` is not part of the identifier name. For example, `@if` declares an identifier named `if`. These [verbatim identifiers](../../language-reference/tokens/verbatim.md) are primarily for interoperability with identifiers declared in other languages.
 
-For a complete definition of valid identifiers, see the [Identifiers topic in the C# Language Specification](~/_csharplang/spec/lexical-structure.md#identifiers).
+For a complete definition of valid identifiers, see the [Identifiers topic in the C# Language Specification](~/_csharpstandard/standard/lexical-structure.md#743-identifiers).
 
 ## Naming conventions
 

docs/csharp/fundamentals/exceptions/creating-and-throwing-exceptions.md

@@ -51,7 +51,7 @@ Add new properties to the exception class when the data they provide is useful t
 
 ## C# Language Specification
 
-For more information, see [Exceptions](~/_csharplang/spec/exceptions.md) and [The throw statement](~/_csharplang/spec/statements.md#the-throw-statement) in the [C# Language Specification](/dotnet/csharp/language-reference/language-specification/introduction). The language specification is the definitive source for C# syntax and usage.
+For more information, see [Exceptions](~/_csharpstandard/standard/exceptions.md) and [The throw statement](~/_csharpstandard/standard/statements.md#13106-the-throw-statement) in the [C# Language Specification](~/_csharpstandard/standard/README.md). The language specification is the definitive source for C# syntax and usage.
 
 ## See also