Feedback

Author: AaronRobinsonMSFT

xml/System.Runtime.InteropServices/Marshal.xml

@@ -304,7 +304,7 @@
 
 ## Remarks
 > [!IMPORTANT]
->  This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, the <xref:System.Runtime.InteropServices.NativeMemory> class should be used to allocate native memory.
+> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, use the <xref:System.Runtime.InteropServices.NativeMemory> class to allocate native memory.
 
  <xref:System.Runtime.InteropServices.Marshal.AllocHGlobal%2A> is one of two memory allocation methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.AllocCoTaskMem%2A?displayProperty=nameWithType> is the other.) This method exposes the Win32 [LocalAlloc](https://go.microsoft.com/fwlink/?LinkId=148628) function from Kernel32.dll.
 
@@ -387,7 +387,7 @@
 
 ## Remarks
 > [!IMPORTANT]
->  This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, the <xref:System.Runtime.InteropServices.NativeMemory> class should be used to allocate native memory.
+> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, use the <xref:System.Runtime.InteropServices.NativeMemory> class to allocate native memory.
 
  <xref:System.Runtime.InteropServices.Marshal.AllocHGlobal%2A> is one of two memory allocation methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.AllocCoTaskMem%2A?displayProperty=nameWithType> is the other.) This method exposes the Win32 [LocalAlloc](https://go.microsoft.com/fwlink/?LinkID=148628) function from Kernel32.dll.
 
@@ -2663,7 +2663,7 @@
 
 ## Remarks
 > [!IMPORTANT]
->  This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, the <xref:System.Runtime.InteropServices.NativeMemory> class should be used to allocate native memory.
+> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, use the <xref:System.Runtime.InteropServices.NativeMemory> class to allocate native memory.
 
  You can use <xref:System.Runtime.InteropServices.Marshal.FreeHGlobal%2A> to free any memory from the global heap allocated by <xref:System.Runtime.InteropServices.Marshal.AllocHGlobal%2A>, <xref:System.Runtime.InteropServices.Marshal.ReAllocHGlobal%2A>, or any equivalent unmanaged API method. If the `hglobal` parameter is <xref:System.IntPtr.Zero?displayProperty=nameWithType> the method does nothing.
 
@@ -9579,7 +9579,7 @@ On .NET 6 and later versions, this method is functionally equivalent to <xref:Sy
 
 ## Remarks
 > [!IMPORTANT]
->  This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, the <xref:System.Runtime.InteropServices.NativeMemory> class should be used to allocate native memory.
+> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On non-Windows platforms, use the <xref:System.Runtime.InteropServices.NativeMemory> class to allocate native memory.
 
  <xref:System.Runtime.InteropServices.Marshal.ReAllocHGlobal%2A> is one of two memory reallocation API methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.ReAllocCoTaskMem%2A?displayProperty=nameWithType> is the other.)