From e9052b90492666c898360e962029944eb81bfd94 Mon Sep 17 00:00:00 2001
From: Peter Ritchie <peteraritchie@users.noreply.github.com>
Date: Fri, 30 Sep 2022 15:25:40 -0400
Subject: [PATCH 1/2] added content for missing error message cs8125

---
 .../compiler-messages/cs8125.md               | 39 +++++++++++++++++++
 .../compiler-messages/toc.yml                 |  2 +
 ...n-t-have-specifics-on-this-csharp-error.md |  1 -
 3 files changed, 41 insertions(+), 1 deletion(-)
 create mode 100644 docs/csharp/language-reference/compiler-messages/cs8125.md

diff --git a/docs/csharp/language-reference/compiler-messages/cs8125.md b/docs/csharp/language-reference/compiler-messages/cs8125.md
new file mode 100644
index 0000000000000..24b61d5da03e1
--- /dev/null
+++ b/docs/csharp/language-reference/compiler-messages/cs8125.md
@@ -0,0 +1,39 @@
+---
+description: "Compiler Error CS8125"
+title: "Compiler Error CS8125"
+ms.date: 9/30/2022
+f1_keywords:
+  - "CS8125"
+helpviewer_keywords:
+  - "CS8125"
+---
+# Compiler Error CS8125
+
+Tuple element name is only allowed at position.
+
+## Example
+
+ The following sample generates CS8125:
+
+```csharp
+// CS8125.cs (2,15)
+
+public class C
+{
+    public void Method()
+    {
+        var tuple3 = (Item2: 2, Item1: 1);
+    }
+}
+```
+
+## To correct this error
+
+If tuple element names `Item1`, `Item2`, etc. are used, ensuring the correct error corrects this error:
+
+```csharp
+    public void Method()
+    {
+        var tuple3 = (Item1: 2, Item2: 1);
+    }
+```
diff --git a/docs/csharp/language-reference/compiler-messages/toc.yml b/docs/csharp/language-reference/compiler-messages/toc.yml
index fc3ae9c6f0379..4af6f16845e68 100644
--- a/docs/csharp/language-reference/compiler-messages/toc.yml
+++ b/docs/csharp/language-reference/compiler-messages/toc.yml
@@ -1603,6 +1603,8 @@ items:
     href: cs7000.md
   - name: CS7003
     href: cs7003.md
+  - name: CS8125
+    href: cs8125.md
   - name: CS8145
     href: cs8145.md
   - name: CS8146
diff --git a/docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md b/docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md
index 167a707ab4e0d..89ea160aaae6f 100644
--- a/docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md
+++ b/docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md
@@ -297,7 +297,6 @@ f1_keywords:
   - "CS8122"
   - "CS8123"
   - "CS8124"
-  - "CS8125"
   - "CS8126"
   - "CS8127"
   - "CS8128"

From 8c9294fc92cc1bd6da012e9a003540dd0f489155 Mon Sep 17 00:00:00 2001
From: Bill Wagner <wiwagn@microsoft.com>
Date: Mon, 3 Oct 2022 10:51:10 -0400
Subject: [PATCH 2/2] Update
 docs/csharp/language-reference/compiler-messages/cs8125.md

---
 docs/csharp/language-reference/compiler-messages/cs8125.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/csharp/language-reference/compiler-messages/cs8125.md b/docs/csharp/language-reference/compiler-messages/cs8125.md
index 24b61d5da03e1..6d7a2a7cb44c6 100644
--- a/docs/csharp/language-reference/compiler-messages/cs8125.md
+++ b/docs/csharp/language-reference/compiler-messages/cs8125.md
@@ -29,7 +29,7 @@ public class C
 
 ## To correct this error
 
-If tuple element names `Item1`, `Item2`, etc. are used, ensuring the correct error corrects this error:
+If tuple element names `Item1`, `Item2`, etc. are used, ensuring the correct order corrects this error:
 
 ```csharp
     public void Method()