Update docs (#1597)

xamarin · Dec 21, 2020 · d901c07 · d901c07
1 parent 2fb7c9e
commit d901c07
Show file tree

Hide file tree

Showing 120 changed files with 666 additions and 1,650 deletions.
diff --git a/docs/en/FrameworksIndex/xamarin-essentials-android.xml b/docs/en/FrameworksIndex/xamarin-essentials-android.xml
@@ -882,6 +882,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -897,6 +898,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials-ios.xml b/docs/en/FrameworksIndex/xamarin-essentials-ios.xml
@@ -878,6 +878,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -893,6 +894,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials-macos.xml b/docs/en/FrameworksIndex/xamarin-essentials-macos.xml
@@ -494,6 +494,7 @@
       <Member Id="M:Xamarin.Essentials.Location.#ctor" />
       <Member Id="M:Xamarin.Essentials.Location.#ctor(System.Double,System.Double)" />
       <Member Id="M:Xamarin.Essentials.Location.#ctor(System.Double,System.Double,System.DateTimeOffset)" />
+      <Member Id="M:Xamarin.Essentials.Location.#ctor(System.Double,System.Double,System.Double)" />
       <Member Id="M:Xamarin.Essentials.Location.#ctor(Xamarin.Essentials.Location)" />
       <Member Id="M:Xamarin.Essentials.Location.CalculateDistance(System.Double,System.Double,System.Double,System.Double,Xamarin.Essentials.DistanceUnits)" />
       <Member Id="M:Xamarin.Essentials.Location.CalculateDistance(System.Double,System.Double,Xamarin.Essentials.Location,Xamarin.Essentials.DistanceUnits)" />
@@ -836,6 +837,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -851,6 +853,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials-tvos.xml b/docs/en/FrameworksIndex/xamarin-essentials-tvos.xml
@@ -843,6 +843,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -858,6 +859,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials-uwp.xml b/docs/en/FrameworksIndex/xamarin-essentials-uwp.xml
@@ -845,6 +845,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -860,6 +861,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials-watchos.xml b/docs/en/FrameworksIndex/xamarin-essentials-watchos.xml
@@ -851,6 +851,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -866,6 +867,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/FrameworksIndex/xamarin-essentials.xml b/docs/en/FrameworksIndex/xamarin-essentials.xml
@@ -815,6 +815,7 @@
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(System.String,System.String)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareFileRequest)" />
+      <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareMultipleFilesRequest)" />
       <Member Id="M:Xamarin.Essentials.Share.RequestAsync(Xamarin.Essentials.ShareTextRequest)" />
     </Type>
     <Type Name="Xamarin.Essentials.ShareFile" Id="T:Xamarin.Essentials.ShareFile">
@@ -830,6 +831,15 @@
       <Member Id="M:Xamarin.Essentials.ShareFileRequest.#ctor(Xamarin.Essentials.ShareFile)" />
       <Member Id="P:Xamarin.Essentials.ShareFileRequest.File" />
     </Type>
+    <Type Name="Xamarin.Essentials.ShareMultipleFilesRequest" Id="T:Xamarin.Essentials.ShareMultipleFilesRequest">
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.FileBase})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.#ctor(System.String,System.Collections.Generic.IEnumerable{Xamarin.Essentials.ShareFile})" />
+      <Member Id="M:Xamarin.Essentials.ShareMultipleFilesRequest.op_Explicit(Xamarin.Essentials.ShareFileRequest)~Xamarin.Essentials.ShareMultipleFilesRequest" />
+      <Member Id="P:Xamarin.Essentials.ShareMultipleFilesRequest.Files" />
+    </Type>
     <Type Name="Xamarin.Essentials.ShareRequestBase" Id="T:Xamarin.Essentials.ShareRequestBase">
       <Member Id="M:Xamarin.Essentials.ShareRequestBase.#ctor" />
       <Member Id="P:Xamarin.Essentials.ShareRequestBase.PresentationSourceBounds" />

diff --git a/docs/en/Xamarin.Essentials/Accelerometer.xml b/docs/en/Xamarin.Essentials/Accelerometer.xml
@@ -14,9 +14,7 @@
     <summary>
       <para>Accelerometer data of the acceleration of the device in three dimensional space.</para>
     </summary>
-    <remarks>
-      <para />
-    </remarks>
+    <remarks></remarks>
   </Docs>
   <Members>
     <Member MemberName="IsMonitoring">
@@ -34,9 +32,7 @@
       <Docs>
         <summary>Gets if accelerometer is being monitored.</summary>
         <value>If monitoring.</value>
-        <remarks>
-          <para />
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ReadingChanged">
@@ -53,9 +49,7 @@
       </ReturnValue>
       <Docs>
         <summary>Event triggered when reading of sensor changes.</summary>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ShakeDetected">
@@ -72,9 +66,7 @@
       </ReturnValue>
       <Docs>
         <summary>Event triggered when a shake has been detected on the device.</summary>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Start">
@@ -115,9 +107,7 @@
       <Parameters />
       <Docs>
         <summary>Stop monitoring for changes to accelerometer.</summary>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>

diff --git a/docs/en/Xamarin.Essentials/AccelerometerChangedEventArgs.xml b/docs/en/Xamarin.Essentials/AccelerometerChangedEventArgs.xml
@@ -12,9 +12,7 @@
   <Interfaces />
   <Docs>
     <summary>Event arguments containing the current reading.</summary>
-    <remarks>
-      <para></para>
-    </remarks>
+    <remarks></remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -50,9 +48,7 @@
       <Docs>
         <summary>The current values of accelerometer.</summary>
         <value>The reading.</value>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>

diff --git a/docs/en/Xamarin.Essentials/AccelerometerData.xml b/docs/en/Xamarin.Essentials/AccelerometerData.xml
@@ -21,9 +21,7 @@
   </Attributes>
   <Docs>
     <summary>Data representing the devies' three accelerometers.</summary>
-    <remarks>
-      <para></para>
-    </remarks>
+    <remarks></remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -84,12 +82,8 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the acceleration vector in G's (gravitational force). </summary>
-        <value>
-          <para />
-        </value>
-        <remarks>
-          <para />
-        </remarks>
+        <value></value>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -111,9 +105,7 @@
         <param name="obj">Object to compare</param>
         <summary>If equal to another object</summary>
         <returns>If equal</returns>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -138,9 +130,7 @@
         <param name="other">Other AccelerometerData to compare with.</param>
         <summary>Compares the underlying Vector3 instances.</summary>
         <returns>True if they are equal, otherwise false.</returns>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -159,9 +149,7 @@
       <Docs>
         <summary>Get the hash code for object.</summary>
         <returns>The hash code</returns>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -185,9 +173,7 @@
         <param name="right">Right to compare</param>
         <summary>Equality operator for equals</summary>
         <returns>If equal</returns>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="op_Inequality">
@@ -211,9 +197,7 @@
         <param name="right">Right to check</param>
         <summary>Inequality check</summary>
         <returns>If not equal</returns>
-        <remarks>
-          <para></para>
-        </remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ToString">

diff --git a/docs/en/Xamarin.Essentials/ActivityState.xml b/docs/en/Xamarin.Essentials/ActivityState.xml
@@ -11,9 +11,7 @@
   </Base>
   <Docs>
     <summary>A state of an Android Activity.</summary>
-    <remarks>
-      <para></para>
-    </remarks>
+    <remarks></remarks>
   </Docs>
   <Members>
     <Member MemberName="Created">