Port assorted docs from runtime (#8414)

* Port assorted docs for GA

* Apply suggestions from code review

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Update xml/System.Runtime.Serialization/ISerializationSurrogateProvider2.xml

Co-authored-by: Steve Molloy <[email protected]>

* Update xml/System.Security.Cryptography.X509Certificates/X509Certificate2.xml

* Update xml/System.Security.Cryptography.X509Certificates/X509AuthorityKeyIdentifierExtension.xml

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Steve Molloy <[email protected]>

Author: 3 people

xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml

@@ -162,6 +162,7 @@
         <summary>Creates an <see cref="T:System.IServiceProvider" /> from the container builder.</summary>
         <returns>The newly created service provider.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:Microsoft.Extensions.DependencyInjection.IServiceProviderFactory`1.CreateServiceProvider(`0)" />
       </Docs>
     </Member>
   </Members>

xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml

@@ -20,8 +20,18 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Used to indicate a byref escapes and is not scoped.</summary>
+    <remarks>
+      <para> There are several cases where the C# compiler treats a <see langword="ref" /> as implicitly <see langword="scoped" /> - where the compiler does not allow the <see langword="ref" /> to escape the method.</para>
+      <para> For example:</para>
+      <ol>
+        <li><see langword="this" /> for <see langword="struct" /> instance methods.</li>
+        <li><see langword="ref" /> parameters that refer to <see langword="ref" /><see langword="struct" /> types.</li>
+        <li><see langword="out" /> parameters.</li>
+      </ol>
+      <para> This attribute is used in those instances where the <see langword="ref" /> should be allowed to escape.</para>
+      <para> Applying this attribute, in any form, has impact on consumers of the applicable API. It is necessary for API authors to understand the lifetime implications of applying this attribute and how it may impact their users.</para>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -37,7 +47,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.UnscopedRefAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics.Eventing.Reader/EventBookmark.xml

@@ -62,8 +62,8 @@
         <Parameter Name="bookmarkXml" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-7.0;windowsdesktop-7.0" />
       </Parameters>
       <Docs>
-        <param name="bookmarkXml">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="bookmarkXml">An XML string that represents the bookmark.</param>
+        <summary>Creates a bookmark that identifies an event in a channel.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -110,7 +110,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the XML string that represents the bookmark.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics/InitializingSwitchEventArgs.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides data for the <see cref="E:System.Diagnostics.Switch.Initializing">Switch.Initializing</see> event.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.Diagnostics/InitializingTraceSourceEventArgs.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides data for the <see cref="E:System.Diagnostics.TraceSource.Initializing">TraceSource.Initializing</see> event.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>

xml/System.Diagnostics/Switch.xml

@@ -319,7 +319,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the default value assigned in the constructor.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -520,7 +520,7 @@
         <ReturnType>System.EventHandler&lt;System.Diagnostics.InitializingSwitchEventArgs&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Occurs when a <see cref="T:System.Diagnostics.Switch" /> needs to be initialized.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -638,7 +638,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Refreshes the trace configuration data.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/Trace.xml

@@ -1159,7 +1159,7 @@ End of list of errors
         <ReturnType>System.EventHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Occurs when a <see cref="T:System.Diagnostics.TraceSource" /> needs to be refreshed from configuration.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/TraceConfiguration.xml

@@ -35,7 +35,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Registers the configuration system to apply settings from configuration files to <see cref="T:System.Diagnostics.TraceSource" /> and related classes.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/TraceSource.xml

@@ -388,7 +388,7 @@ The preceding .NET Framework app configuration file example demonstrates removin
         <ReturnType>System.Diagnostics.SourceLevels</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the default level assigned in the constructor.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -527,7 +527,7 @@ The preceding .NET Framework app configuration file example demonstrates removin
         <ReturnType>System.EventHandler&lt;System.Diagnostics.InitializingTraceSourceEventArgs&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Occurs when a <see cref="T:System.Diagnostics.TraceSource" /> needs to be initialized.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Formats.Asn1/AsnWriter.xml

@@ -62,10 +62,16 @@
         <Parameter Name="initialCapacity" Type="System.Int32" Index="1" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="ruleSet">To be added.</param>
-        <param name="initialCapacity">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="ruleSet">The encoding constraints for the writer.</param>
+        <param name="initialCapacity">The minimum capacity with which to initialize the underlying buffer.</param>
+        <summary>Initializes a new instance of <see cref="T:System.Formats.Asn1.AsnWriter" /> with a given set of encoding rules and an initial capacity.</summary>
+        <remarks>Specifying <paramref name="initialCapacity" /> with a value of zero behaves as if no initial capacity were specified.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="ruleSet" /> is not defined.
+
+-or-
+
+<paramref name="initialCapacity" /> is a negative number.</exception>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">