Port .NET 7.0 Preview1 documentation

xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml

@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Removes all keys and values from the cache.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml

@@ -253,9 +253,18 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets a value that indicates whether to track linked entries.</summary>
+        <value>
+          <see langword="true" /> if linked entries are tracked; otherwise, <see langword="false" />. The default is <see langword="false" /> in .NET 7 and later versions.</value>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Prior to .NET 7 this feature was always enabled.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.Extensions.Configuration/ConfigurationDebugViewContext.xml

@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides data about the current item of the configuration.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -67,7 +67,7 @@
         <ReturnType>Microsoft.Extensions.Configuration.IConfigurationProvider</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> that was used to get the value of the current item.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -88,7 +88,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the key of the current item.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -109,7 +109,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the path of the current item.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -130,7 +130,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the value of the current item.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Configuration/ConfigurationRootExtensions.xml

@@ -71,10 +71,10 @@
         <Parameter Name="processValue" Type="System.Func&lt;Microsoft.Extensions.Configuration.ConfigurationDebugViewContext,System.String&gt;" Index="1" FrameworkAlternate="dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="root">To be added.</param>
-        <param name="processValue">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="root">The configuration root.</param>
+        <param name="processValue">A function for processing the value, for example, to hide secrets, where the <see cref="T:Microsoft.Extensions.Configuration.ConfigurationDebugViewContext"/> represents the context of the current configuration item, and the string is assigned as the value of the configuration section.</param>
+        <summary>Generates a human-readable view of the configuration showing where each value came from.</summary>
+        <returns>The debug view.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.DependencyModel/Dependency.xml

@@ -85,9 +85,10 @@
         <Parameter Name="other" Type="Microsoft.Extensions.DependencyModel.Dependency" />
       </Parameters>
       <Docs>
-        <param name="other">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="other">An object to compare with this object.</param>
+        <summary>Indicates whether the current object is equal to another object of the same type.</summary>
+        <returns>
+          <see langword="true" /> if the current object is equal to the <paramref name="other" /> parameter; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.Primitives/StringSegment.xml

@@ -436,6 +436,7 @@
       </Parameters>
       <Docs>
         <inheritdoc />
+        <summary>Indicates whether the current object is equal to another object of the same type.</summary>
       </Docs>
     </Member>
     <Member MemberName="Equals">

xml/System.Buffers/SequenceReader`1.xml

@@ -956,10 +956,11 @@ This method copies a fixed amount of data out of the sequence if possible. It do
         <Parameter Name="sequence" Type="System.Buffers.ReadOnlySequence&lt;T&gt;" RefType="out" Index="1" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="count">To be added.</param>
-        <param name="sequence">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="count">The number of values to read.</param>
+        <param name="sequence">When this method returns, contains the read data, if <paramref name="count" /> items were successfully read.</param>
+        <summary>Attempts to read exactly <paramref name="count" /> values from the current sequence.</summary>
+        <returns>
+          <see langword="true" /> if there are <paramref name="count" /> or more remaining items in the current sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Collections.Generic/CollectionExtensions.xml

@@ -63,11 +63,13 @@
         <Parameter Name="list" Type="System.Collections.Generic.IList&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="list">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of elements in the collection.</typeparam>
+        <param name="list">The list to wrap.</param>
+        <summary>Returns a read-only <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> wrapper for the specified list.</summary>
+        <returns>An object that acts as a read-only wrapper around the current <see cref="T:System.Collections.Generic.IList`1" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="list" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="AsReadOnly&lt;TKey,TValue&gt;">
@@ -96,12 +98,14 @@
         <Parameter Name="dictionary" Type="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
       </Parameters>
       <Docs>
-        <typeparam name="TKey">To be added.</typeparam>
-        <typeparam name="TValue">To be added.</typeparam>
-        <param name="dictionary">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="TKey">The type of keys in the dictionary.</typeparam>
+        <typeparam name="TValue">The type of values in the dictionary.</typeparam>
+        <param name="dictionary">The dictionary to wrap.</param>
+        <summary>Returns a read-only <see cref="T:System.Collections.ObjectModel.ReadOnlyDictionary`2" /> wrapper for the current dictionary.</summary>
+        <returns>An object that acts as a read-only wrapper around the current <see cref="T:System.Collections.Generic.IDictionary`2" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="dictionary" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultAssets">

xml/System.Diagnostics.CodeAnalysis/ConstantExpectedAttribute.xml

@@ -20,8 +20,16 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Indicates that the specified method parameter expects a constant.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute can be used to inform tooling that a constant should be used as an argument for the annotated parameter.
+
+      ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -57,7 +65,7 @@
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the maximum bound of the expected constant, inclusive.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -78,7 +86,7 @@
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the minimum bound of the expected constant, inclusive.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics.CodeAnalysis/RequiresDynamicCodeAttribute.xml

@@ -20,8 +20,16 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Indicates that the specified method requires the ability to generate new code at runtime, for example through <see cref="N:System.Reflection" />.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute allows tools to understand which methods are unsafe to call when compiling ahead of time.
+
+      ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -40,8 +48,8 @@
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="message">A message that contains information about the usage of dynamic code.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute" /> class with the specified message.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -61,7 +69,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets a message that contains information about the usage of dynamic code.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -82,7 +90,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets an optional URL that contains more information about the method, why it requires dynamic code, and what options a consumer has to deal with it.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics.CodeAnalysis/StringSyntaxAttribute.xml

@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies the syntax used in a string.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -40,8 +40,8 @@
         <Parameter Name="syntax" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="syntax">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="syntax">The syntax identifier.</param>
+        <summary>Initializes the <see cref="T:System.Diagnostics.CodeAnalysis.StringSyntaxAttribute" /> with the identifier of the syntax used.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -69,9 +69,9 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="syntax">To be added.</param>
-        <param name="arguments">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="syntax">The syntax identifier.</param>
+        <param name="arguments">Optional arguments associated with the specific syntax employed.</param>
+        <summary>Initializes the <see cref="T:System.Diagnostics.CodeAnalysis.StringSyntaxAttribute" /> with the identifier of the syntax used.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -91,7 +91,7 @@
         <ReturnType>System.Object[]</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the optional arguments associated with the specific syntax employed.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -112,7 +112,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing date and time format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -132,7 +132,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing JavaScript Object Notation (JSON).</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -152,7 +152,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing regular expressions.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -172,7 +172,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the identifier of the syntax used.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics/Activity.xml

@@ -761,9 +761,17 @@ The best practice for the library authors is not try to set this property. This
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets a value that indicates whether this <see cref="T:System.Diagnostics.Activity" /> object is stopped or not.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+When subscribing to <xref:System.Diagnostics.Activity> stop event using <xref:System.Diagnostics.ActivityListener.ActivityStopped>, the received <xref:System.Diagnostics.Activity> object in the event callback will have <xref:System.Diagnostics.Activity.IsStopped> as `true`.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Kind">

xml/System.Diagnostics/ActivityContext.xml

@@ -428,12 +428,13 @@ ActivityContext contains the property `IsRemote`, which is not part of W3C. `IsR
         <Parameter Name="context" Type="System.Diagnostics.ActivityContext" RefType="out" Index="3" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="traceParent">To be added.</param>
-        <param name="traceState">To be added.</param>
-        <param name="isRemote">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="traceParent">The W3C trace parent header.</param>
+        <param name="traceState">The W3C trace state.</param>
+        <param name="isRemote">
+          <see langword="true" /> to propagate the context from the remote parent; otherwise, <see langword="false" />.</param>
+        <param name="context">When this method returns, contains the <see cref="T:System.Diagnostics.ActivityContext"/> object created from the parsing operation.</param>
+        <summary>Tries to parse the W3C trace context headers to the <see cref="T:System.Diagnostics.ActivityContext"/> object.</summary>
+        <returns><see langword="true"/> if the operation succeeds; <see langword="false"/> otherwise.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Drawing/Graphics.xml

@@ -6972,9 +6972,9 @@ The number of points in the array should be a multiple of 3 plus 1 because the f
         <Parameter Name="rect" Type="System.Drawing.RectangleF" Index="1" FrameworkAlternate="dotnet-plat-ext-7.0;windowsdesktop-7.0" />
       </Parameters>
       <Docs>
-        <param name="pen">To be added.</param>
-        <param name="rect">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="pen">A pen that determines the color, width, and style of the rectangle.</param>
+        <param name="rect">The rectangle to draw.</param>
+        <summary>Draws the outline of the specified rectangle.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -11284,11 +11284,11 @@ The number of points in the array should be a multiple of 3 plus 1 because the f
         <Parameter Name="sweepAngle" Type="System.Single" Index="3" FrameworkAlternate="dotnet-plat-ext-7.0;windowsdesktop-7.0" />
       </Parameters>
       <Docs>
-        <param name="brush">To be added.</param>
-        <param name="rect">To be added.</param>
-        <param name="startAngle">To be added.</param>
-        <param name="sweepAngle">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="brush">A brush that determines the characteristics of the fill.</param>
+        <param name="rect">The bounding rectangle that defines the ellipse from which the pie section comes.</param>
+        <param name="startAngle">Angle in degrees measured clockwise from the x-axis to the first side of the pie section.</param>
+        <param name="sweepAngle">Angle in degrees measured clockwise from the <paramref name="startAngle" /> parameter to the second side of the pie section.</param>
+        <summary>Fills the interior of a pie section defined by an ellipse and two radial lines.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>