Add namespace summaries for System* namespaces (#11138)

gewarren · web-flow · commit 60b48d6aec15 · 2025-03-28T09:49:15.000-07:00
diff --git a/xml/ns-System.Cloud.DocumentDb.xml b/xml/ns-System.Cloud.DocumentDb.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Cloud.DocumentDb">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and interfaces for managing document-oriented (NoSQL) databases, including database configuration, query execution, transactional operations, and exception handling. </summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Cloud.Messaging.xml b/xml/ns-System.Cloud.Messaging.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Cloud.Messaging">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and extension methods for building and managing asynchronous message processing pipelines.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Collections.Frozen.xml b/xml/ns-System.Collections.Frozen.xml
@@ -1,6 +1,8 @@
 <Namespace Name="System.Collections.Frozen">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+      Contains types that provide immutable, read-only collections optimized for fast lookup and enumeration.
+    </summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Binding.xml b/xml/ns-System.CommandLine.Binding.xml
@@ -1,6 +1,9 @@
 <Namespace Name="System.CommandLine.Binding">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+      Provides types for binding command-line input to objects, including support for custom types,
+      binding contexts, and value descriptors.
+    </summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Builder.xml b/xml/ns-System.CommandLine.Builder.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.Builder">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides classes and extension methods for building and configuring command-line applications.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Completions.xml b/xml/ns-System.CommandLine.Completions.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.Completions">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and interfaces for command-line completion operations, including contexts, items, and sources for generating completions.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Help.xml b/xml/ns-System.CommandLine.Help.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.Help">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and methods for formatting and displaying command-line help.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.IO.xml b/xml/ns-System.CommandLine.IO.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.IO">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types for working with standard input, output, and error streams, including in-memory and console-based implementations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Invocation.xml b/xml/ns-System.CommandLine.Invocation.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.Invocation">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types for handling command invocation, including context, handlers, results, middleware, and middleware ordering.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.Parsing.xml b/xml/ns-System.CommandLine.Parsing.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine.Parsing">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and methods for parsing command-line input, including arguments, options, commands, and tokens.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.CommandLine.xml b/xml/ns-System.CommandLine.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.CommandLine">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types for defining commands, options, arguments, and their relationships in command-line applications.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Data.Sql.xml b/xml/ns-System.Data.Sql.xml
@@ -4,11 +4,7 @@
     <remarks>
       <format type="text/markdown"><![CDATA[
 
-## Remarks
- For information about the functionality that the classes within this namespace support, see [Enumerating Instances of SQL Server (ADO.NET)](/dotnet/framework/data/adonet/sql/enumerating-instances-of-sql-server) and [Query Notifications in SQL Server](/dotnet/framework/data/adonet/sql/query-notifications-in-sql-server).
-
-> [!NOTE]
->  In beta releases of ADO.NET version 2.0, the <xref:System.Data.Sql> namespace also contained classes for use with SQL Server common language runtime (CLR) integration. However, those classes have been moved into their own namespace, <xref:Microsoft.SqlServer.Server>. For more information about using SQL Server CLR integration, see [SQL Server Common Language Runtime Integration](/dotnet/framework/data/adonet/sql/sql-server-common-language-runtime-integration).
+For information about the functionality of the classes within this namespace, see [Enumerating Instances of SQL Server (ADO.NET)](/dotnet/framework/data/adonet/sql/enumerating-instances-of-sql-server) and [Query Notifications in SQL Server](/dotnet/framework/data/adonet/sql/query-notifications-in-sql-server).
 
  ]]></format>
     </remarks>
diff --git a/xml/ns-System.Drawing.Design.xml b/xml/ns-System.Drawing.Design.xml
@@ -8,7 +8,7 @@
  The classes in this namespace can be used to create custom toolbox items, type-specific value editors that can edit and graphically represent values of their supported types, and type converters that can convert values between certain types. This namespace provides the basic frameworks for developing extensions to the design-time UI.
 
 > [!CAUTION]
->  Classes within the <xref:System.Drawing.Design> namespace are not supported for use within a Windows or ASP.NET service. Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.
+> Classes within the <xref:System.Drawing.Design> namespace are not supported for use within a Windows or ASP.NET service. Attempting to use these classes from within one of these application types might produce unexpected problems, such as diminished service performance and run-time exceptions.
 
  ]]></format>
     </remarks>
diff --git a/xml/ns-System.Formats.Nrbf.xml b/xml/ns-System.Formats.Nrbf.xml
@@ -1,6 +1,9 @@
 <Namespace Name="System.Formats.Nrbf">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+      Provides classes and utilities for working with .NET Remoting Binary Format (NRBF) encoded data,
+      including support for decoding payloads, handling serialization records, and managing array and class records.
+    </summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Globalization.xml b/xml/ns-System.Globalization.xml
@@ -9,7 +9,6 @@
 The following blogs include discussions of the <xref:System.Globalization> namespace and its classes:
 
 - <https://learn.microsoft.com/archive/blogs/shawnste/>
-
 - <https://learn.microsoft.com/archive/blogs/kierans/>
 
 Two of the .NET types in this namespace, <xref:System.Globalization.CultureAndRegionInfoBuilder> and <xref:System.Globalization.CultureAndRegionModifiers>, are found in an assembly named *sysglobl.dll*. To successfully compile code that uses these types, add a reference to sysglobl.dll.
diff --git a/xml/ns-System.Net.Http.xml b/xml/ns-System.Net.Http.xml
@@ -44,6 +44,5 @@ If your app uses the <xref:System.Net.Http> and <xref:System.Net.Http.Headers> n
  ]]></format>
     </remarks>
     <altmember cref="N:System.Net.Http.Headers" />
-    <related type="Article" href="https://learn.microsoft.com/previous-versions/windows/apps/hh761504(v=win.10)">Connecting to a web service</related>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Net.ServerSentEvents.xml b/xml/ns-System.Net.ServerSentEvents.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Net.ServerSentEvents">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides classes and delegates for working with server-sent events, including formatting, parsing, and representing event data.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Numerics.Tensors.xml b/xml/ns-System.Numerics.Tensors.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Numerics.Tensors">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides types and methods for tensor operations and memory management.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Runtime.Diagnostics.xml b/xml/ns-System.Runtime.Diagnostics.xml
diff --git a/xml/ns-System.Runtime.Intrinsics.Arm.Arm64.xml b/xml/ns-System.Runtime.Intrinsics.Arm.Arm64.xml
diff --git a/xml/ns-System.Runtime.Intrinsics.Arm.xml b/xml/ns-System.Runtime.Intrinsics.Arm.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Runtime.Intrinsics.Arm">
   <Docs>
-    <summary>Exposes select instruction-set extensions for ARM systems. These instruction sets are expressed as separate classes for each extension. Support for any extension within the current environment can be determined by querying the <see langword="IsSupported" /> property on the respective type.</summary>
+    <summary>Exposes select instruction-set extensions for ARM systems. These instruction sets are expressed as separate classes for each extension. You can determine support for any extension within the current environment by querying the <see langword="IsSupported" /> property on the respective type.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Runtime.Loader.xml b/xml/ns-System.Runtime.Loader.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Runtime.Loader">
   <Docs>
-    <summary>Provides interfaces and classes to allow developers the opportunity to influence runtime loading behavior.</summary>
+    <summary>Provides interfaces and classes to influence runtime loading behavior.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Runtime.Remoting.Channels.Smtp.xml b/xml/ns-System.Runtime.Remoting.Channels.Smtp.xml
diff --git a/xml/ns-System.Runtime.xml b/xml/ns-System.Runtime.xml
@@ -1,11 +1,10 @@
 <Namespace Name="System.Runtime">
   <Docs>
-    <summary>Contains advanced types that support diverse namespaces such as the <see langword="System" />, <see langword="Runtime" />, and the <see langword="Security" /> namespaces.</summary>
+    <summary>Contains advanced types that support diverse namespaces such as the <see langword="System" />, <see langword="Runtime" />, and <see langword="Security" /> namespaces.</summary>
     <remarks>
       <format type="text/markdown"><![CDATA[
 
-## Remarks
- The types found in this namespace are intended for use in advanced development.
+The types found in this namespace are intended for use in advanced development.
 
  ]]></format>
     </remarks>
diff --git a/xml/ns-System.Text.Json.Schema.xml b/xml/ns-System.Text.Json.Schema.xml
@@ -1,6 +1,6 @@
 <Namespace Name="System.Text.Json.Schema">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides functionality for generating JSON schema objects from .NET types using metadata and context.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Text.Json.Serialization.Metadata.xml b/xml/ns-System.Text.Json.Serialization.Metadata.xml
@@ -1,6 +1,8 @@
 <Namespace Name="System.Text.Json.Serialization.Metadata">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+      Contains classes, structs, and interfaces that provide metadata and configuration for JSON serialization and deserialization in System.Text.Json.
+    </summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>
diff --git a/xml/ns-System.Text.Json.SourceGeneration.xml b/xml/ns-System.Text.Json.SourceGeneration.xml
diff --git a/xml/ns-System.Web.UI.MobileControls.ShippedAdapterSource.xml b/xml/ns-System.Web.UI.MobileControls.ShippedAdapterSource.xml
diff --git a/xml/ns-System.Windows.Forms.Analyzers.xml b/xml/ns-System.Windows.Forms.Analyzers.xml
diff --git a/xml/ns-System.Windows.Forms.Design.Resources.xml b/xml/ns-System.Windows.Forms.Design.Resources.xml
