Automatic port of System.Diagnostics.CodeAnalysis documentation (#4671)

* Automatic port of System.Diagnostics.CodeAnalysis documentation

* Apply suggestions from code review

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

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

Author: carlossanlop

xml/System.Diagnostics.CodeAnalysis/DynamicDependencyAttribute.xml

@@ -20,8 +20,16 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>States a dependency that one member has on another.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute can be used to inform tooling of a dependency that is otherwise not evident purely from metadata and IL, for example, a member relied on via reflection.
+
+          ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -40,8 +48,8 @@
         <Parameter Name="memberSignature" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="memberSignature">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberSignature">The signature of the member depended on.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute" /> class with the specified signature of a member on the same type as the consumer.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -62,9 +70,9 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="memberTypes">To be added.</param>
-        <param name="type">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberTypes">The types of members depended on.</param>
+        <param name="type">The type that contains the specified members.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute" /> class with the specified types of members on a <see cref="T:System.Type" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -85,9 +93,9 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="memberSignature">To be added.</param>
-        <param name="type">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberSignature">The signature of the member depended on.</param>
+        <param name="type">The type that contains <paramref name="memberSignature" />.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute" /> class with the specified signature of a member on a <see cref="T:System.Type" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -109,10 +117,10 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="memberTypes">To be added.</param>
-        <param name="typeName">To be added.</param>
-        <param name="assemblyName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberTypes">The types of members depended on.</param>
+        <param name="typeName">The full name of the type containing the specified members.</param>
+        <param name="assemblyName">The assembly name of the type containing the specified members.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute" /> class with the specified types of members on a type in an assembly.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -134,10 +142,10 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="memberSignature">To be added.</param>
-        <param name="typeName">To be added.</param>
-        <param name="assemblyName">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberSignature">The signature of the member depended on.</param>
+        <param name="typeName">The full name of the type containing the specified member.</param>
+        <param name="assemblyName">The assembly name of the type containing the specified member.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute" /> class with the specified signature of a member on a type in an assembly.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -157,9 +165,17 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the assembly name of the specified type.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.AssemblyName> is only valid when <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.TypeName> is specified.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Condition">
@@ -178,7 +194,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the condition in which the dependency is applicable, for example, "DEBUG".</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -199,9 +215,17 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the signature of the member depended on.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Either <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.MemberSignature> must be a valid string or <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.MemberTypes> must not equal <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.None>, but not both.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="MemberTypes">
@@ -220,9 +244,17 @@
         <ReturnType>System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the types of the members that are depended on, for example, fields and properties.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Either <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.MemberSignature> must be a valid string or <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.MemberTypes> must not equal <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.None>, but not both.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Type">
@@ -241,9 +273,17 @@
         <ReturnType>System.Type</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:System.Type" /> containing the specified member.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.Type> and <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.TypeName> aren't specified, the type of the consumer is assumed.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TypeName">
@@ -262,9 +302,17 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the full name of the type containing the specified member.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.Type> and <xref:System.Diagnostics.CodeAnalysis.DynamicDependencyAttribute.TypeName> aren't specified, the type of the consumer is assumed.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>

xml/System.Diagnostics.CodeAnalysis/DynamicallyAccessedMemberTypes.xml

@@ -19,7 +19,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies the types of members that are dynamically accessed.
+             This enumeration has a <see cref="T:System.FlagsAttribute" /> attribute that allows a bitwise combination of its member values.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -40,7 +41,8 @@
       </ReturnValue>
       <MemberValue>-1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all members.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -60,7 +62,8 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies no members.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicConstructors">
@@ -80,7 +83,8 @@
       </ReturnValue>
       <MemberValue>4</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public constructors.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicEvents">
@@ -100,7 +104,8 @@
       </ReturnValue>
       <MemberValue>4096</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public events.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicFields">
@@ -120,7 +125,8 @@
       </ReturnValue>
       <MemberValue>64</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public fields.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicMethods">
@@ -140,7 +146,8 @@
       </ReturnValue>
       <MemberValue>16</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public methods.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicNestedTypes">
@@ -160,7 +167,8 @@
       </ReturnValue>
       <MemberValue>256</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public nested types.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NonPublicProperties">
@@ -180,7 +188,8 @@
       </ReturnValue>
       <MemberValue>1024</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public properties.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicConstructors">
@@ -200,7 +209,8 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public constructors.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicEvents">
@@ -220,7 +230,8 @@
       </ReturnValue>
       <MemberValue>2048</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public events.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicFields">
@@ -240,7 +251,8 @@
       </ReturnValue>
       <MemberValue>32</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public fields.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicMethods">
@@ -260,7 +272,8 @@
       </ReturnValue>
       <MemberValue>8</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public methods.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicNestedTypes">
@@ -280,7 +293,8 @@
       </ReturnValue>
       <MemberValue>128</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public nested types.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicParameterlessConstructor">
@@ -300,7 +314,8 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies the default, parameterless public constructor.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
     <Member MemberName="PublicProperties">
@@ -320,7 +335,8 @@
       </ReturnValue>
       <MemberValue>512</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public properties.</summary>
+        <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>

xml/System.Diagnostics.CodeAnalysis/DynamicallyAccessedMembersAttribute.xml

@@ -20,8 +20,19 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Indicates that certain members on a specified <see cref="T:System.Type" /> are accessed dynamically, for example, through <see cref="N:System.Reflection" />.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This attribute allows tools to understand which members are being accessed during the execution of a program.
+             This attribute is valid on members whose type is <xref:System.Type> or <xref:System.String>.
+             When this attribute is applied to a location of type <xref:System.String>, the assumption is that the string represents a fully qualified type name.
+             If the attribute is applied to a method, it's treated as a special case and it implies that the attribute should be applied to the "this" parameter of the method. The attribute should only be used on instance methods of types that are assignable to <xref:System.Type> (or `string`, but no methods will use it there).
+
+          ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -40,8 +51,8 @@
         <Parameter Name="memberTypes" Type="System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes" />
       </Parameters>
       <Docs>
-        <param name="memberTypes">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="memberTypes">The types of the dynamically accessed members.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembersAttribute" /> class with the specified member types.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -61,7 +72,7 @@
         <ReturnType>System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes" /> that specifies the type of dynamically accessed members.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>