Doc updates for InteropServices. (dotnet#4734)

Author: AaronRobinsonMSFT

xml/System.Runtime.InteropServices/Architecture.xml

@@ -134,7 +134,7 @@
  </ReturnValue>
  <MemberValue>4</MemberValue>
  <Docs>
- <summary>To be added.</summary>
+ <summary>The WebAssembly platform.</summary>
  </Docs>
  </Member>
  <Member MemberName="X64">

xml/System.Runtime.InteropServices/CollectionsMarshal.xml

@@ -40,12 +40,12 @@
  <Parameter Name="list" Type="System.Collections.Generic.List&lt;T&gt;" />
  </Parameters>
  <Docs>
- <typeparam name="T">To be added.</typeparam>
- <param name="list">To be added.</param>
+ <typeparam name="T">The type of items in the list.</typeparam>
+ <param name="list">List from which to create the <see cref="T:System.Span`1" /></param>
  <summary>Gets a <see cref="T:System.Span`1" /> view over the data in a list.
  Items should not be added or removed from the <see cref="T:System.Collections.Generic.List`1" /> while the <see cref="T:System.Span`1" /> is in use.</summary>
- <returns>To be added.</returns>
-  <remarks>To be added.</remarks>
+ <returns>A <see cref="T:System.Span`1" /> instance over the <see cref="T:System.Collections.Generic.List`1" /></returns>
+ <remarks>To be added.</remarks>
  </Docs>
  </Member>
  </Members>

xml/System.Runtime.InteropServices/ComWrappers+ComInterfaceDispatch.xml

@@ -66,7 +66,7 @@
  <ReturnType>System.IntPtr</ReturnType>
  </ReturnValue>
  <Docs>
- <summary>To be added.</summary>
+ <summary>Field that represents the virtual function table (vtable) in the IUnknown instance layout.</summary>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>

xml/System.Runtime.InteropServices/ComWrappers.xml

@@ -1,4 +1,4 @@
-<Type Name="ComWrappers" FullName="System.Runtime.InteropServices.ComWrappers">
+<Type Name="ComWrappers" FullName="System.Runtime.InteropServices.ComWrappers">
  <TypeSignature Language="C#" Value="public abstract class ComWrappers" />
  <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit ComWrappers extends System.Object" />
  <TypeSignature Language="DocId" Value="T:System.Runtime.InteropServices.ComWrappers" />
@@ -37,7 +37,7 @@
  </AssemblyInfo>
  <Parameters />
  <Docs>
- <summary>To be added.</summary>
+ <summary>Instance constructor.</summary>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>
@@ -239,8 +239,16 @@ If a managed object was previously created for the specified `externalComObject`
  <param name="wrapper">The object to use as the wrapper for the external object.</param>
  <summary>Gets the currently registered managed object or uses the supplied managed object and registers it.</summary>
  <returns>A managed object associated with the supplied external COM object.</returns>
- <remarks>To be added.</remarks>
  <exception cref="T:System.NotSupportedException">The wrapper instance is already associated with an external object.</exception>
+ <remarks>
+ <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the `wrapper` instance already has an associated external object a <xref:System.NotSupportedException> will be thrown.
+
+ ]]></format>
+ </remarks>
  </Docs>
  </Member>
  <Member MemberName="RegisterForMarshalling">

xml/System.Runtime.InteropServices/CreateComInterfaceFlags.xml

@@ -69,7 +69,7 @@ This flag is useful in scenarios when the caller has no need to rely on an IUnkn
  </ReturnValue>
  <MemberValue>0</MemberValue>
  <Docs>
- <summary>To be added.</summary>
+ <summary>Flag used to indicate no flags set.</summary>
  </Docs>
  </Member>
  <Member MemberName="TrackerSupport">

xml/System.Runtime.InteropServices/CreateObjectFlags.xml

@@ -40,7 +40,7 @@
  </ReturnValue>
  <MemberValue>0</MemberValue>
  <Docs>
- <summary>To be added.</summary>
+ <summary>Flag used to indicate no flags set.</summary>
  </Docs>
  </Member>
  <Member MemberName="TrackerObject">

xml/System.Runtime.InteropServices/DynamicInterfaceCastableImplementationAttribute.xml

@@ -45,7 +45,7 @@ This attribute is used to enforce policy in the runtime and make <xref:System.Ru
  </AssemblyInfo>
  <Parameters />
  <Docs>
- <summary>To be added.</summary>
+ <summary>Instance constructor.</summary>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>

xml/System.Runtime.InteropServices/MemoryMarshal.xml

@@ -603,7 +603,7 @@ This method can be useful if part of a managed object represents a fixed array.
  <typeparam name="T">The type of the array elements.</typeparam>
  <param name="array">The array to analyze.</param>
  <summary>Returns a reference to the 0th element of <paramref name="array" />. If the array is empty, returns a reference to where the 0th element would have been stored. Such a reference may be used for pinning but must never be dereferenced.</summary>
- <returns>To be added.</returns>
+ <returns>Reference to the 0th element in <paramref name="array" /></returns>
  <remarks>
  <format type="text/markdown"><![CDATA[
 

xml/System.Runtime.InteropServices/OSPlatform.xml

@@ -64,8 +64,8 @@
  <ReturnType>System.Runtime.InteropServices.OSPlatform</ReturnType>
  </ReturnValue>
  <Docs>
- <summary>To be added.</summary>
- <value>To be added.</value>
+ <summary>Gets an object that represents the Browser as an operating system.</summary>
+ <value>An object that represents the Browser as an operating system.</value>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>

xml/System.Runtime.InteropServices/SuppressGCTransitionAttribute.xml

@@ -65,7 +65,7 @@ This attribute is ignored if applied to a method without the <xref:System.Runtim
  </AssemblyInfo>
  <Parameters />
  <Docs>
- <summary>To be added.</summary>
+ <summary>Instance constructor.</summary>
  <remarks>To be added.</remarks>
  </Docs>
  </Member>