Merge main into live

.github/workflows/markdownlint.yml

@@ -25,7 +25,7 @@ jobs:
     steps:
       - uses: actions/[email protected]
       - name: Use Node.js
-        uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d
+        uses: actions/setup-node@8f152de45cc393bb48ce5d89d36b731f54556e65
         with:
           node-version: 16.x
       - name: Run Markdownlint

.openpublishing.redirection.csharp.json

@@ -319,6 +319,10 @@
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs0650.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs0767.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs0826.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
@@ -343,6 +347,10 @@
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs0854.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/expression-tree-restrictions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs1741.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs1921.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
@@ -351,6 +359,10 @@
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs1946.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/expression-tree-restrictions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs1988.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs3007.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
@@ -371,10 +383,34 @@
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8155.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#conversion-to-expression-trees"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8166.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8167.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8168.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8169.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8175.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#syntax-limitations-in-lambda-expressions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8373.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8374.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/compiler-messages/cs8401.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/feature-version-errors"
@@ -783,6 +819,10 @@
             "source_path_from_root": "/docs/csharp/language-reference/keywords/implicit.md",
             "redirect_url": "/dotnet/csharp/language-reference/operators/user-defined-conversion-operators"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/keywords/in-parameter-modifier.md",
+            "redirect_url": "/dotnet/csharp/language-reference/keywords/method-parameters#in-parameter-modifier"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/keywords/int.md",
             "redirect_url": "/dotnet/csharp/language-reference/builtin-types/integral-numeric-types"
@@ -851,6 +891,14 @@
             "source_path_from_root": "/docs/csharp/language-reference/keywords/operator.md",
             "redirect_url": "/dotnet/csharp/language-reference/operators/operator-overloading"
         },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/keywords/out-parameter-modifier.md",
+            "redirect_url": "/dotnet/csharp/language-reference/keywords/method-parameters#out-parameter-modifier"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/language-reference/keywords/params.md",
+            "redirect_url": "/dotnet/csharp/language-reference/keywords/method-parameters#params-modifier"
+        },
         {
             "source_path_from_root": "/docs/csharp/language-reference/keywords/reference-tables-for-types.md",
             "redirect_url": "/dotnet/csharp/language-reference/keywords"
@@ -1276,6 +1324,18 @@
             "source_path_from_root": "/docs/csharp/misc/cs0171.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/feature-version-errors"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs0192.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs0199.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs0206.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs0248.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/feature-version-errors"
@@ -1340,6 +1400,10 @@
             "source_path_from_root": "/docs/csharp/misc/cs0623.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs0631.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs0687.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/using-directive-errors"
@@ -1388,6 +1452,10 @@
             "source_path_from_root": "/docs/csharp/misc/cs0838.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/expression-tree-restrictions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1510.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs1529.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/using-directive-errors"
@@ -1404,10 +1472,18 @@
             "source_path_from_root": "/docs/csharp/misc/cs1586.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1605.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs1621.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#syntax-limitations-in-lambda-expressions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1623.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs1628.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#syntax-limitations-in-lambda-expressions"
@@ -1416,6 +1492,22 @@
             "source_path_from_root": "/docs/csharp/misc/cs1632.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#syntax-limitations-in-lambda-expressions"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1649.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1651.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1655.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1657.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs1673.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/lambda-expression-errors#syntax-limitations-in-lambda-expressions"
@@ -1436,6 +1528,10 @@
             "source_path_from_root": "/docs/csharp/misc/cs1925.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/array-declaration-errors"
         },
+        {
+            "source_path_from_root": "/docs/csharp/misc/cs1939.md",
+            "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/ref-modifiers-errors"
+        },
         {
             "source_path_from_root": "/docs/csharp/misc/cs1944.md",
             "redirect_url": "/dotnet/csharp/language-reference/compiler-messages/expression-tree-restrictions"

docfx.json

@@ -56,7 +56,8 @@
                     "csharp-12.0/using-alias-types.md",
                     "csharp-12.0/lambda-method-group-defaults.md",
                     "csharp-12.0/inline-arrays.md",
-                    "csharp-12.0/experimental-attribute.md"
+                    "csharp-12.0/experimental-attribute.md",
+                    "csharp-12.0/ref-readonly-parameters.md"
                 ],
                 "src": "_csharplang/proposals",
                 "dest": "csharp/language-reference/proposals",
@@ -688,6 +689,7 @@
                 "_csharplang/proposals/csharp-12.0/inline-arrays.md": "Inline arrays, or fixed sized buffers",
                 "_csharplang/proposals/csharp-12.0/collection-expressions.md": "Collection expressions",
                 "_csharplang/proposals/csharp-12.0/experimental-attribute.md": "Experimental attribute",
+                "_csharplang/proposals/csharp-12.0/ref-readonly-parameters.md": "Ref readonly parameters",
 
 
                 "_roslyn/docs/compilers/CSharp/Compiler Breaking Changes - DotNet 7.md": "C# compiler breaking changes since C# 10",
@@ -803,6 +805,7 @@
                 "_csharplang/proposals/csharp-12.0/inline-arrays.md": "Inline arrays provide a general-purpose and safe mechanism for declaring inline arrays within C# classes, structs, and interfaces.",
                 "_csharplang/proposals/csharp-12.0/collection-expressions.md": "Collection expressions provide a concise syntax to initialize collections by defining elements or embedded collections as the source of the new collection's elements.",
                 "_csharplang/proposals/csharp-12.0/experimental-attribute.md": "Use the ExperimentalAttribute attribute to indicate APIs that aren't stable.",
+                "_csharplang/proposals/csharp-12.0/ref-readonly-parameters.md": "Ref readonly parameters enforce that arguments are passed by references, where `in` parameters allow the compiler some flexibiility.",
 
                 "_roslyn/docs/compilers/CSharp/Compiler Breaking Changes - DotNet 7.md": "Learn about any breaking changes since the initial release of C# 10",
                 "_roslyn/docs/compilers/CSharp/Compiler Breaking Changes - DotNet 8.md": "Learn about any breaking changes since the initial release of C# 11",