docs

Author: SimonCropp

api_list.include.md

@@ -625,7 +625,7 @@
 
 #### KeyValuePair
 
- * `KeyValuePair<TKey, TValue> Create<TKey, TValue>(TKey, TValue)`
+ * `KeyValuePair<TKey, TValue> Create<TKey, TValue>(TKey, TValue)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.keyvaluepair.create)
 
 
 #### TaskCompletionSource

readme.md

@@ -322,20 +322,17 @@ public class OverloadResolutionPriorityAttributeTests
 
 Reference: [Low Level Struct Improvements](https://github.com/dotnet/csharplang/blob/main/proposals/csharp-11.0/low-level-struct-improvements.md)
 
-<!-- snippet: UnscopedRefUsage.cs -->
-<a id='snippet-UnscopedRefUsage.cs'></a>
+<!-- snippet: UnscopedRefUsage -->
+<a id='snippet-UnscopedRefUsage'></a>
 ```cs
-using System.Diagnostics.CodeAnalysis;
-#pragma warning disable CS0169 // Field is never used
-
 struct UnscopedRefUsage
 {
     int field1;
 
     [UnscopedRef] ref int Prop1 => ref field1;
 }
 ```
-<sup><a href='/src/Consume/UnscopedRefUsage.cs#L1-L9' title='Snippet source file'>snippet source</a> | <a href='#snippet-UnscopedRefUsage.cs' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Consume/UnscopedRefUsage.cs#L5-L12' title='Snippet source file'>snippet source</a> | <a href='#snippet-UnscopedRefUsage' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 
@@ -1079,7 +1076,7 @@ The class `Polyfill` includes the following extension methods:
 
 #### KeyValuePair
 
- * `KeyValuePair<TKey, TValue> Create<TKey, TValue>(TKey, TValue)`
+ * `KeyValuePair<TKey, TValue> Create<TKey, TValue>(TKey, TValue)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.keyvaluepair.create)
 
 
 #### TaskCompletionSource<!-- endInclude -->

src/Consume/Consume.cs

@@ -88,6 +88,7 @@ class Consume
         type = typeof(UnreachableException);
         type = typeof(DebuggerDisableUserUnhandledExceptionsAttribute);
 
+        KeyValuePair.Create("a", "b");
         // Test to make sure there are no clashes in the Polyfill code with classes that
         // might be defined in user code. See comments in Debug.cs for more details.
         Debug.Log("Test log to make sure this is working");

src/Consume/UnscopedRefUsage.cs

@@ -1,10 +1,12 @@
 using System.Diagnostics.CodeAnalysis;
 #pragma warning disable CS0169 // Field is never used
 
+// ReSharper disable once ReplaceWithFieldKeyword
+#region UnscopedRefUsage
 struct UnscopedRefUsage
 {
-    // ReSharper disable once ReplaceWithFieldKeyword
     int field1;
 
     [UnscopedRef] ref int Prop1 => ref field1;
-}
+}
+#endregion

src/Polyfill/KeyValuePair.cs

@@ -19,7 +19,15 @@ namespace System.Collections.Generic;
 #endif
 static class KeyValuePair
 {
-    // Creates a new KeyValuePair<TKey, TValue> from the given values.
+    /// <summary>
+    /// Creates a new key/value pair instance using provided values.
+    /// </summary>
+    /// <param name="key">The key of the new <see cref="KeyValuePair{TKey,TValue}"/> to be created.</param>
+    /// <param name="value">The value of the new <see cref="KeyValuePair{TKey,TValue}"/> to be created.</param>
+    /// <typeparam name="TKey">The type of the key.</typeparam>
+    /// <typeparam name="TValue">The type of the value.</typeparam>
+    /// <returns>A key/value pair containing the provided arguments as values.</returns>
+    //Link: https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.keyvaluepair.create
     public static KeyValuePair<TKey, TValue> Create<TKey, TValue>(TKey key, TValue value) =>
         new KeyValuePair<TKey, TValue>(key, value);
 }