Add namespace summaries for System* namespaces (#11138)

Author: gewarren

Diff for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: 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 for: xml/ns-System.Runtime.Diagnostics.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 for: xml/ns-System.Runtime.Intrinsics.Arm.Arm64.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 for: xml/ns-System.Runtime.Intrinsics.Arm.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 for: xml/ns-System.Runtime.Loader.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 for: xml/ns-System.Runtime.Remoting.Channels.Smtp.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>