Updated File.Create (#3061)

* Updated File.Create summaries

Added missing buffer size information and made the wording of all four summaries the same.

* Updated File.Create path parameter descriptions

Also made the wording of all four path parameter descriptions the same.

* Shortened the summary

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

* Shortened the summary

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

Author: JeroenOortwijn

xml/System.IO/File.xml

@@ -889,7 +889,7 @@
         <AssemblyVersion>4.1.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Creates a file in the specified path.</summary>
+        <summary>Creates or overwrites a file in the specified path.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName="Create">
@@ -1026,9 +1026,9 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="path">The name of the file.</param>
+        <param name="path">The path and name of the file to create.</param>
         <param name="bufferSize">The number of bytes buffered for reads and writes to the file.</param>
-        <summary>Creates or overwrites the specified file.</summary>
+        <summary>Creates or overwrites a file in the specified path, specifying a buffer size.</summary>
         <returns>A <see cref="T:System.IO.FileStream" /> with the specified buffer size that provides read/write access to the file specified in <paramref name="path" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -1120,10 +1120,10 @@
         <Parameter Name="options" Type="System.IO.FileOptions" Index="2" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
       </Parameters>
       <Docs>
-        <param name="path">The name of the file.</param>
+        <param name="path">The path and name of the file to create.</param>
         <param name="bufferSize">The number of bytes buffered for reads and writes to the file.</param>
         <param name="options">One of the <see cref="T:System.IO.FileOptions" /> values that describes how to create or overwrite the file.</param>
-        <summary>Creates or overwrites the specified file, specifying a buffer size and a <see cref="T:System.IO.FileOptions" /> value that describes how to create or overwrite the file.</summary>
+        <summary>Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.</summary>
         <returns>A new file with the specified buffer size.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -1189,11 +1189,11 @@
         <Parameter Name="fileSecurity" Type="System.Security.AccessControl.FileSecurity" Index="3" FrameworkAlternate="netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
       </Parameters>
       <Docs>
-        <param name="path">The name of the file.</param>
+        <param name="path">The path and name of the file to create.</param>
         <param name="bufferSize">The number of bytes buffered for reads and writes to the file.</param>
         <param name="options">One of the <see cref="T:System.IO.FileOptions" /> values that describes how to create or overwrite the file.</param>
         <param name="fileSecurity">One of the <see cref="T:System.Security.AccessControl.FileSecurity" /> values that determines the access control and audit security for the file.</param>
-        <summary>Creates or overwrites the specified file with the specified buffer size, file options, and file security.</summary>
+        <summary>Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.</summary>
         <returns>A new file with the specified buffer size, file options, and file security.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[