Port System.ComponentModel.Composition source comments to Docs (#2489)

* Port System.ComponentModel.Composition source comments to Docs

* Apply suggestions from code review

Suggestions by rpetrusha

Co-Authored-By: Ron Petrusha <[email protected]>

Author: carlossanlop

xml/System.ComponentModel.Composition/ExportAttribute.xml

@@ -191,7 +191,15 @@
         <param name="contractName">The contract name that is used to export the type or member marked with this attribute, or <see langword="null" /> or an empty string ("") to use the default contract name.</param>
         <param name="contractType">The type to export.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.ExportAttribute" /> class, exporting the specified type under the specified contract name.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+The default contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on the property or field type, or on the type itself that this is marked with this attribute. 
+                
+The contract name is compared using a case-sensitive, non-linguistic comparison using <xref:System.StringComparer.Ordinal?displayProperty=nameWithType>.
+                    
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ContractName">
@@ -249,4 +257,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.ComponentModel.Composition/InheritedExportAttribute.xml

@@ -54,7 +54,15 @@
       <Parameters />
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.InheritedExportAttribute" /> class.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+The default contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on the type itself that is marked with this attribute. 
+                    
+The contract name is compared using a case-sensitive, non-linguistic comparison using <xref:System.StringComparer.Ordinal?displayProperty=nameWithType>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -81,7 +89,15 @@
       <Docs>
         <param name="contractName">The name of the contract.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.InheritedExportAttribute" /> class with the specified contract name.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+          
+The default contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on the type itself that this is marked with this attribute.
+
+The contract name is compared using a case-sensitive, non-linguistic comparison using <xref:System.StringComparer.Ordinal?displayProperty=nameWithType>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -108,7 +124,17 @@
       <Docs>
         <param name="contractType">The type of the contract.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.InheritedExportAttribute" /> class with the specified contract type.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+The contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on `contractType`.
+                
+The default contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on the type itself that is marked with this attribute. 
+                
+The contract name is compared using a case-sensitive, non-linguistic comparison using <xref:System.StringComparer.Ordinal?displayProperty=nameWithType>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -137,8 +163,16 @@
         <param name="contractName">The name of the contract.</param>
         <param name="contractType">The type of the contract.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.InheritedExportAttribute" /> class with the specified contract name and type.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+The default contract name is the result of calling <xref:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)?displayProperty=nameWithType> on the type itself that this is marked with this attribute. 
+                
+The contract name is compared using a case-sensitive, non-linguistic comparison using <xref:System.StringComparer.Ordinal?displayProperty=nameWithType>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.ComponentModel.Composition/MetadataViewImplementationAttribute.xml

@@ -50,7 +50,13 @@
       <Docs>
         <param name="implementationType">The type of the metadata view.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.Composition.MetadataViewImplementationAttribute" /> class.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+By default, MetadataViews are generated using reflection emit.  This attribute allows the developer to specify the type that implements the view rather than using a generated type.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ImplementationType">
@@ -76,4 +82,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>