Filled in the docs.

2017-02-06 16:34:03 -06:00 · 2017-02-06 16:34:03 -06:00 · 7c134380bf
--- a/docs/en/SkiaSharp/SK3dView.xml
+++ b/docs/en/SkiaSharp/SK3dView.xml
@ -10,8 +10,10 @@
  </Base>
  <Interfaces />
  <Docs>
-    <summary>To be added.</summary>
+    <summary>A utility class that can be used to create 3D transformations.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
      <para></para>
    </remarks>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
@ -23,8 +25,10 @@
      </AssemblyInfo>
      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates a new instance of <see cref="T:SkiaSharp.SK3dView" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ApplyToCanvas">
@ -41,9 +45,11 @@
        <Parameter Name="canvas" Type="SkiaSharp.SKCanvas" />
      </Parameters>
      <Docs>
-        <param name="canvas">To be added.</param>
+        <param name="canvas">The canvas to apply the transformation to.</param>
-        <summary>To be added.</summary>
+        <summary>Applies the current transformation to the specfied canvas.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Dispose">
@ -66,14 +72,14 @@
      </Docs>
    </Member>
    <Member MemberName="DotWithNormal">
-      <MemberSignature Language="C#" Value="public void DotWithNormal (float dx, float dy, float dz);" />
+      <MemberSignature Language="C#" Value="public float DotWithNormal (float dx, float dy, float dz);" />
-      <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void DotWithNormal(float32 dx, float32 dy, float32 dz) cil managed" />
+      <MemberSignature Language="ILAsm" Value=".method public hidebysig instance float32 DotWithNormal(float32 dx, float32 dy, float32 dz) cil managed" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>1.56.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
-        <ReturnType>System.Void</ReturnType>
+        <ReturnType>System.Single</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="dx" Type="System.Single" />
@ -81,11 +87,13 @@
        <Parameter Name="dz" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="dx">To be added.</param>
+        <param name="dx">The x-axis of the normal.</param>
-        <param name="dy">To be added.</param>
+        <param name="dy">The y-axis of the normal.</param>
-        <param name="dz">To be added.</param>
+        <param name="dz">The z-axis of the normal.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the dot product of the current transformation and the specified normal.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetMatrix">
@ -102,9 +110,11 @@
        <Parameter Name="matrix" Type="SkiaSharp.SKMatrix&amp;" RefType="ref" />
      </Parameters>
      <Docs>
-        <param name="matrix">To be added.</param>
+        <param name="matrix">The matrix to store the transformation.</param>
-        <summary>To be added.</summary>
+        <summary>Stores the current transformation in the specified matrix.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Matrix">
@ -118,9 +128,13 @@
        <ReturnType>SkiaSharp.SKMatrix</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the current transformation as a matrix.</summary>
-        <value>To be added.</value>
+        <value>
-        <remarks>To be added.</remarks>
+          <para></para>
        </value>
        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Restore">
@ -135,8 +149,10 @@
      </ReturnValue>
      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Restores the transformation to the last saved with <see cref="M:SkiaSharp.SK3dView.Save" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateXDegrees">
@ -153,9 +169,11 @@
        <Parameter Name="degrees" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="degrees">To be added.</param>
+        <param name="degrees">The degrees to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the x-axis by the specified degrees.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateXRadians">
@ -172,9 +190,11 @@
        <Parameter Name="radians" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="radians">To be added.</param>
+        <param name="radians">The radians to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the x-axis by the specified radians.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateYDegrees">
@ -191,9 +211,11 @@
        <Parameter Name="degrees" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="degrees">To be added.</param>
+        <param name="degrees">The degrees to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the y-axis by the specified degrees.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateYRadians">
@ -210,9 +232,11 @@
        <Parameter Name="radians" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="radians">To be added.</param>
+        <param name="radians">The radians to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the y-axis by the specified radians.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateZDegrees">
@ -229,9 +253,11 @@
        <Parameter Name="degrees" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="degrees">To be added.</param>
+        <param name="degrees">The degrees to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the z-axis by the specified degrees.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="RotateZRadians">
@ -248,9 +274,11 @@
        <Parameter Name="radians" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="radians">To be added.</param>
+        <param name="radians">The radians to rotate by.</param>
-        <summary>To be added.</summary>
+        <summary>Rotates the transformation along the z-axis by the specified radians.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Save">
@ -265,8 +293,10 @@
      </ReturnValue>
      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Saves the current transformation so that it can be restored later using <see cref="M:SkiaSharp.SK3dView.Restore" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Translate">
@ -285,11 +315,13 @@
        <Parameter Name="z" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The amount to translate by along the x-axis.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The amount to translate by along the y-axis.</param>
-        <param name="z">To be added.</param>
+        <param name="z">The amount to translate by along the z-axis.</param>
-        <summary>To be added.</summary>
+        <summary>Translates the transformation.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="TranslateX">
@ -306,9 +338,11 @@
        <Parameter Name="x" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The amount to translate by.</param>
-        <summary>To be added.</summary>
+        <summary>Translates the transformation along the x-axis.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="TranslateY">
@ -325,9 +359,11 @@
        <Parameter Name="y" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="y">To be added.</param>
+        <param name="y">The amount to translate by.</param>
-        <summary>To be added.</summary>
+        <summary>Translates the transformation along the y-axis.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="TranslateZ">
@ -344,9 +380,11 @@
        <Parameter Name="z" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="z">To be added.</param>
+        <param name="z">The amount to translate by.</param>
-        <summary>To be added.</summary>
+        <summary>Translates the transformation along the z-axis.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/SkiaSharp/SKBitmap.xml
+++ b/docs/en/SkiaSharp/SKBitmap.xml
@ -40,7 +40,7 @@
      </AssemblyInfo>
      <Parameters />
      <Docs>
-        <summary>Default construct creates a bitmap with zero width and height, and no pixels. Its colortype is set to <see cref="E:SkiaSharp.SKColorType.Unknown." /></summary>
+        <summary>Default constructor that creates a bitmap with zero width and height, and no pixels. Its colortype is set to <see cref="E:SkiaSharp.SKColorType.Unknown." /></summary>
        <remarks>This constructor does not allocate a backing store for the bitmap.</remarks>
      </Docs>
    </Member>
@ -901,7 +901,9 @@
      </ReturnValue>
      <Docs>
        <summary>Gets a value indicating whether drawing this bitmap has any effect.</summary>
-        <value>Returns true if drawing this bitmap would have no effect.</value>
+        <value>
          <para />
        </value>
        <remarks>
          <para></para>
        </remarks>
@ -975,10 +977,12 @@
        <Parameter Name="destination" Type="SkiaSharp.SKBitmap" />
      </Parameters>
      <Docs>
-        <param name="destination">To be added.</param>
+        <param name="destination">The bitmap to be filled with alpha layer.</param>
-        <summary>To be added.</summary>
+        <summary>Retrieve the alpha layer of this bitmap.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns true if the alpha layer was retrieved, false otherwise.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ExtractAlpha">
@ -996,11 +1000,13 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="destination">To be added.</param>
+        <param name="destination">The bitmap to be filled with alpha layer.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to draw with.</param>
-        <summary>To be added.</summary>
+        <summary>Retrieve the alpha layer of this bitmap after applying the specified paint.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns true if the alpha layer was retrieved, false otherwise.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ExtractAlpha">
@ -1018,11 +1024,13 @@
        <Parameter Name="offset" Type="SkiaSharp.SKPointI&amp;" RefType="out" />
      </Parameters>
      <Docs>
-        <param name="destination">To be added.</param>
+        <param name="destination">The bitmap to be filled with alpha layer.</param>
-        <param name="offset">To be added.</param>
+        <param name="offset">The top-left coordinate to position the retrieved bitmap so that it visually lines up with the original.</param>
-        <summary>To be added.</summary>
+        <summary>Retrieve the alpha layer of this bitmap.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns true if the alpha layer was retrieved, false otherwise.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ExtractAlpha">
@ -1041,12 +1049,14 @@
        <Parameter Name="offset" Type="SkiaSharp.SKPointI&amp;" RefType="out" />
      </Parameters>
      <Docs>
-        <param name="destination">To be added.</param>
+        <param name="destination">The bitmap to be filled with alpha layer.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to draw with.</param>
-        <param name="offset">To be added.</param>
+        <param name="offset">The top-left coordinate to position the retrieved bitmap so that it visually lines up with the original.</param>
-        <summary>To be added.</summary>
+        <summary>Retrieve the alpha layer of this bitmap after applying the specified paint.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns true if the alpha layer was retrieved, false otherwise.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="ExtractSubset">
@ -1064,11 +1074,11 @@
        <Parameter Name="subset" Type="SkiaSharp.SKRectI" />
      </Parameters>
      <Docs>
-        <param name="destination">To be added.</param>
+        <param name="destination">The bitmap that will be set to a subset of this bitmap.</param>
-        <param name="subset">To be added.</param>
+        <param name="subset">The rectangle of pixels in this bitmap that the destination will reference.</param>
-        <summary>To be added.</summary>
+        <summary>Retrieve a subset of this bitmap.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns true if the subset was retrieved, false otherwise.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>If possible, the retrieved bitmap will share the pixel memory, and just point into a subset of it. However, if the color type does not support this, a local copy will be made and associated with the destination bitmap.</remarks>
      </Docs>
    </Member>
    <Member MemberName="GetAddr">
@ -1086,11 +1096,13 @@
        <Parameter Name="y" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the pixel.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the pixel.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the address of the specified pixel.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the address of the specified pixel.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetAddr16">
@ -1108,11 +1120,13 @@
        <Parameter Name="y" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the pixel.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the pixel.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the 16-bit value of the specified pixel.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the 16-bit value of the specified pixel.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetAddr32">
@ -1130,11 +1144,13 @@
        <Parameter Name="y" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the pixel.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the pixel.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the 32-bit value of the specified pixel.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the 32-bit value of the specified pixel.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetAddr8">
@ -1152,11 +1168,13 @@
        <Parameter Name="y" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the pixel.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the pixel.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the 8-bit value of the specified pixel.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the 8-bit value of the specified pixel.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetIndex8Color">
--- a/docs/en/SkiaSharp/SKBlurMaskFilterFlags.xml
+++ b/docs/en/SkiaSharp/SKBlurMaskFilterFlags.xml
@ -14,8 +14,10 @@
    </Attribute>
  </Attributes>
  <Docs>
-    <summary>To be added.</summary>
+    <summary>Flags to use with <see cref="M:SkiaSharp.SKMaskFilter.CreateBlur" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
      <para />
    </remarks>
  </Docs>
  <Members>
    <Member MemberName="All">
@ -29,7 +31,7 @@
        <ReturnType>SkiaSharp.SKBlurMaskFilterFlags</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Apply all the flags.</summary>
      </Docs>
    </Member>
    <Member MemberName="HighQuality">
@ -43,7 +45,7 @@
        <ReturnType>SkiaSharp.SKBlurMaskFilterFlags</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Use a smother, higher qulity blur algorithm.</summary>
      </Docs>
    </Member>
    <Member MemberName="IgnoreTransform">
@ -57,7 +59,7 @@
        <ReturnType>SkiaSharp.SKBlurMaskFilterFlags</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>The blur layer's radius is not affected by transforms.</summary>
      </Docs>
    </Member>
    <Member MemberName="None">
@ -71,7 +73,7 @@
        <ReturnType>SkiaSharp.SKBlurMaskFilterFlags</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Do not apply any of the flags.</summary>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/SkiaSharp/SKCanvas.xml
+++ b/docs/en/SkiaSharp/SKCanvas.xml
@ -483,7 +483,7 @@
      <Docs>
        <param name="bitmap">The bitmap to draw.</param>
        <param name="dest">The region to draw the bitmap into.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws a bitmap on the canvas.</summary>
        <remarks>
          <para></para>
@ -517,7 +517,7 @@
        <param name="bitmap">The bitmap to draw.</param>
        <param name="source">The source region to copy.</param>
        <param name="dest">The region to draw the bitmap into.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws a bitmap on the canvas.</summary>
        <remarks>
          <para></para>
@ -549,9 +549,9 @@
      </Parameters>
      <Docs>
        <param name="bitmap">Bitmap to draw</param>
-        <param name="x">Targe x coordinate destination for the bitmap.</param>
+        <param name="x">Targe x-coordinate destination for the bitmap.</param>
-        <param name="y">Target y coordinate destination for the bitmap.</param>
+        <param name="y">Target y-coordinate destination for the bitmap.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws a bitmap on the canvas.</summary>
        <remarks>
          <para></para>
@ -579,7 +579,7 @@
        <param name="bitmap">The bitmap to draw.</param>
        <param name="lattice">The lattice that describes the areas of the bitmap to stretch or shrink.</param>
        <param name="dst">The region to draw the bitmap into.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws the bitmap, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -611,7 +611,7 @@
        <param name="xDivs">The x-coordinates that divide the bitmap vertically, describing the areas to stretch or shrink.</param>
        <param name="yDivs">The y-coordinates that divide the bitmap horizontally, describing the areas to stretch or shrink.</param>
        <param name="dst">The region to draw the bitmap into.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws the bitmap, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -641,7 +641,7 @@
        <param name="bitmap">The bitmap to draw.</param>
        <param name="center">The center region within the bitmap to logically divide the bitmap into 9 sections (3x3).</param>
        <param name="dst">The region to draw the bitmap into.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws the bitmap, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -674,7 +674,7 @@
        <param name="cx">The center x-coordinate.</param>
        <param name="cy">The center y-coordinate.</param>
        <param name="radius">The radius for the circle.</param>
-        <param name="paint">The paint used to draw the bitmap.</param>
+        <param name="paint">The paint to use when drawing the bitmap.</param>
        <summary>Draws a circle on the canvas.</summary>
        <remarks>
          <para></para>
@ -765,7 +765,7 @@
      <Docs>
        <param name="image">The image to draw.</param>
        <param name="dest">The region to draw the image into.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws an image on the canvas.</summary>
        <remarks>
          <para></para>
@ -799,7 +799,7 @@
        <param name="image">The image to draw.</param>
        <param name="source">The source region to copy.</param>
        <param name="dest">The region to draw the image into.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws an image on the canvas.</summary>
        <remarks>
          <para></para>
@ -833,7 +833,7 @@
        <param name="image">The image to draw.</param>
        <param name="x">The x-coordinate destination for the image.</param>
        <param name="y">The y-coordinate destination for the image.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws an image on the canvas.</summary>
        <remarks>
          <para></para>
@ -861,7 +861,7 @@
        <param name="image">The image to draw.</param>
        <param name="lattice">The lattice that describes the areas of the image to stretch or shrink.</param>
        <param name="dst">The region to draw the image into.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws the image, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -893,7 +893,7 @@
        <param name="xDivs">The x-coordinates that divide the image vertically, describing the areas to stretch or shrink.</param>
        <param name="yDivs">The Y-coordinates that divide the image horizontally, describing the areas to stretch or shrink.</param>
        <param name="dst">The region to draw the image into.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws the image, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -923,7 +923,7 @@
        <param name="image">The image to draw.</param>
        <param name="center">The center region within the image to logically divide the image into 9 sections (3x3).</param>
        <param name="dst">The region to draw the image into.</param>
-        <param name="paint">The paint used to draw the image, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the image, or <see langword="null" />.</param>
        <summary>Draws the image, stretched or shrunk differentially to fit into the destination rectangle.</summary>
        <remarks>
          <para></para>
@ -959,7 +959,7 @@
        <param name="y0">The first point y-coordinate.</param>
        <param name="x1">The second point x-coordinate.</param>
        <param name="y1">The second point y-coordinate.</param>
-        <param name="paint">The paint used to draw the line.</param>
+        <param name="paint">The paint to use when drawing the line.</param>
        <summary>Draws a line on the canvas.</summary>
        <remarks>
          <para></para>
@ -1081,7 +1081,7 @@
      </Parameters>
      <Docs>
        <param name="rect">The bounding box for the oval.</param>
-        <param name="paint">The paint used to draw the oval.</param>
+        <param name="paint">The paint to use when drawing the oval.</param>
        <summary>Draws an oval on the canvas.</summary>
        <remarks>
          <para></para>
@ -1111,7 +1111,7 @@
        <param name="cy">The center y-coordinate.</param>
        <param name="rx">The vertical radius for the oval.</param>
        <param name="ry">The horizontal radius for the oval.</param>
-        <param name="paint">The paint used to draw the oval.</param>
+        <param name="paint">The paint to use when drawing the oval.</param>
        <summary>Draws an oval on the canvas.</summary>
        <remarks>
          <para></para>
@ -1169,7 +1169,7 @@
      </Parameters>
      <Docs>
        <param name="path">The path to draw.</param>
-        <param name="paint">The paint used to draw the path.</param>
+        <param name="paint">The paint to use when drawing the path.</param>
        <summary>Draws a path in the canvas.</summary>
        <remarks>
          <para></para>
@ -1199,7 +1199,7 @@
      </Parameters>
      <Docs>
        <param name="picture">The picture to draw.</param>
-        <param name="paint">The paint used to draw the picture, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the picture, or <see langword="null" />.</param>
        <summary>Draws a picture on the canvas.</summary>
        <remarks>
          <para></para>
@ -1231,7 +1231,7 @@
      <Docs>
        <param name="picture">The picture to draw.</param>
        <param name="matrix">The matrix to apply while painting.</param>
-        <param name="paint">The paint used to draw the picture, or <see langword="null" />.</param>
+        <param name="paint">The paint to use when drawing the picture, or <see langword="null" />.</param>
        <summary>Draws a picture on the canvas.</summary>
        <remarks>
          <para>This is equivalent to calling <see cref="M:SkiaSharp.SKCanvas.Save" />, followed by <see cref="M:SkiaSharp.SKCanvas.Concat" /> with the specified <paramref name="matrix" />, <see cref="M:SkiaSharp.SKCanvas.DrawPicture" /> and then <see cref="M:SkiaSharp.SKCanvas.Restore" />.</para>
@ -1297,7 +1297,7 @@
      <Docs>
        <param name="x">The x-coordinate for the point to draw.</param>
        <param name="y">The y-coordinate for the point to draw.</param>
-        <param name="paint">The paint used to draw the point.</param>
+        <param name="paint">The paint to use when drawing the point.</param>
        <summary>Draws a point in the canvas with the specified color.</summary>
        <remarks>
          <para></para>
@ -1329,7 +1329,7 @@
      <Docs>
        <param name="mode">Determines how the points array will be interpreted: as points, as coordinates to draw lines, or as coordinates of a polygon.</param>
        <param name="points">The array of points to draw.</param>
-        <param name="paint">The paint used to draw the points.</param>
+        <param name="paint">The paint to use when drawing the points.</param>
        <summary>Draws an array of points, lines or a polygon in the canvas, one at a time.</summary>
        <remarks>
          <para>For <see cref="F:SkiaSharp.SKPointMode.Points" />, each point is drawn centered at its coordinate, and its size is specified by the paint's stroke-width. It draws as a square, unless the paint's <see cref="P:SkiaSharp.SKPaint.StrokeCap" /> is <see cref="F:SkiaSharp.SKStrokeCap.Round" />, in which the points are drawn as circles.</para>
@ -1359,11 +1359,13 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to draw.</param>
-        <param name="points">To be added.</param>
+        <param name="points">The positions for each glyph in the <paramref name="text" /> string.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws glyphs of the text at specified locations on the canvas.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawPositionedText">
@ -1385,10 +1387,10 @@
      <Docs>
        <param name="text">The text to draw.</param>
        <param name="points">The positions for each glyph in the <paramref name="text" /> string.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws glyphs of the text at specified locations on the canvas.</summary>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -1413,10 +1415,10 @@
        <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
        <param name="points">The positions for each glyph in the <paramref name="buffer." /></param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text from a UTF-8 buffer at specified locations on the canvas.</summary>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -1443,7 +1445,7 @@
      </Parameters>
      <Docs>
        <param name="rect">The rectangle to draw.</param>
-        <param name="paint">The paint used to draw the rectagle.</param>
+        <param name="paint">The paint to use when drawing the rectagle.</param>
        <summary>Draws a rectangle in the canvas.</summary>
        <remarks>
          <para></para>
@ -1467,10 +1469,10 @@
      </Parameters>
      <Docs>
        <param name="region">The region to be drawn.</param>
-        <param name="paint">The paint used to draw the region.</param>
+        <param name="paint">The paint to use when drawing the region.</param>
        <summary>Draws the outline of the specified region using the specified paint.</summary>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -1500,7 +1502,7 @@
        <param name="rect">The rectangle to draw.</param>
        <param name="rx">The x-radius of the oval used to round the corners.</param>
        <param name="ry">The y-radius of the oval used to round the corners.</param>
-        <param name="paint">The paint used to draw the rectagle.</param>
+        <param name="paint">The paint to use when drawing the rectagle.</param>
        <summary>Draws a rounded rectangle in the canvas.</summary>
        <remarks>
          <para></para>
@ -1537,7 +1539,7 @@
      <Docs>
        <param name="text">The text to draw.</param>
        <param name="points">The positions for each glyph in the <paramref name="text" /> string.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws glyphs of the text at specified locations on the canvas.</summary>
        <remarks>
          <para></para>
@ -1561,12 +1563,14 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to draw.</param>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the origin of the text being drawn.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the origin of the text being drawn.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws text on the canvas at the specified coordinates.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawText">
@ -1601,7 +1605,7 @@
        <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
        <param name="points">The positions for each glyph in the <paramref name="buffer." /></param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text from a UTF-8 buffer at specified locations on the canvas.</summary>
        <remarks />
      </Docs>
@ -1633,7 +1637,7 @@
        <param name="text">The text to draw.</param>
        <param name="x">The x-coordinate of the origin of the text being drawn.</param>
        <param name="y">The y-coordinate of the origin of the text being drawn.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text on the canvas at the specified coordinates.</summary>
        <remarks>
          <para></para>
@ -1699,13 +1703,15 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to draw.</param>
-        <param name="path">To be added.</param>
+        <param name="path">The path the text should follow for its baseline.</param>
-        <param name="hOffset">To be added.</param>
+        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
-        <param name="vOffset">To be added.</param>
+        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws text on the canvas following a path.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawText">
@ -1737,7 +1743,7 @@
        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
        <param name="x">The x-coordinate of the origin of the text being drawn.</param>
        <param name="y">The y-coordinate of the origin of the text being drawn.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text encoded in a UTF-8 buffer on the canvas at the specified coordinates.</summary>
        <remarks>
          <para></para>
@ -1778,7 +1784,7 @@
        <param name="path">The path the text should follow for its baseline.</param>
        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text on the canvas following a path.</summary>
        <remarks>
          <para></para>
@ -1821,7 +1827,7 @@
        <param name="path">The path the text should follow for its baseline.</param>
        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">The paint used to draw the text.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
        <summary>Draws text encoded in a UTF-8 buffer on the canvas following a path.</summary>
        <remarks>
          <para></para>
@ -1846,13 +1852,15 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to draw.</param>
-        <param name="path">To be added.</param>
+        <param name="path">The path the text should follow for its baseline.</param>
-        <param name="hOffset">To be added.</param>
+        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
-        <param name="vOffset">To be added.</param>
+        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws text on the canvas following a path.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawTextOnPath">
@ -1873,13 +1881,15 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to draw.</param>
-        <param name="path">To be added.</param>
+        <param name="path">The path the text should follow for its baseline.</param>
-        <param name="hOffset">To be added.</param>
+        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
-        <param name="vOffset">To be added.</param>
+        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws text on the canvas following a path.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawTextOnPath">
@ -1901,14 +1911,16 @@
        <Parameter Name="paint" Type="SkiaSharp.SKPaint" />
      </Parameters>
      <Docs>
-        <param name="buffer">To be added.</param>
+        <param name="buffer">The pointer to a region holding UTF-8 encoded text to draw.</param>
-        <param name="length">To be added.</param>
+        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
-        <param name="path">To be added.</param>
+        <param name="path">The path the text should follow for its baseline.</param>
-        <param name="hOffset">To be added.</param>
+        <param name="hOffset">The distance along the path to add to the text’s starting position.</param>
-        <param name="vOffset">To be added.</param>
+        <param name="vOffset">The distance above (-) or below (+) the path to position the text.</param>
-        <param name="paint">To be added.</param>
+        <param name="paint">The paint to use when drawing the text.</param>
-        <summary>To be added.</summary>
+        <summary>Draws text encoded in a UTF-8 buffer on the canvas following a path.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="DrawUrlAnnotation">
--- a/docs/en/SkiaSharp/SKCodec.xml
+++ b/docs/en/SkiaSharp/SKCodec.xml
@ -40,7 +40,7 @@
        <Parameter Name="data" Type="SkiaSharp.SKData" />
      </Parameters>
      <Docs>
-        <param name="data">The data to create the codec with.</param>
+        <param name="data">The data to use when creating the codec.</param>
        <summary>Creates a codec from the specified data.</summary>
        <returns>Returns the new instance of the codec, or null if there was an error.</returns>
        <remarks>
@ -67,12 +67,10 @@
        <Parameter Name="stream" Type="SkiaSharp.SKStream" />
      </Parameters>
      <Docs>
-        <param name="stream">The stream to create the codec with.</param>
+        <param name="stream">The stream to use when creating the codec.</param>
        <summary>Creates a codec from the specified stream.</summary>
        <returns>Returns the new instance of the codec, or null if there was an error.</returns>
-        <remarks>
+        <remarks>If null is returned, the stream is deleted immediately. Otherwise, the codec takes ownership of it, and will delete it when done with it.</remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Dispose">
@ -194,10 +192,10 @@
        <Parameter Name="inputScanline" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="inputScanline">To be added.</param>
+        <param name="inputScanline">The scanline that is located in the encoded data.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the output y-coordinate of the row that corresponds to an input y-coordinate.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the output y-coordinate of the row.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>This will equal <paramref name="inputScanline" />, except in the case of strangely encoded image types (bottom-up bmps, interlaced gifs).</remarks>
      </Docs>
    </Member>
    <Member MemberName="GetPixels">
@ -632,12 +630,12 @@
        <Parameter Name="rowBytes" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="dst">To be added.</param>
+        <param name="dst">The memory location to store the scanlines.</param>
-        <param name="countLines">To be added.</param>
+        <param name="countLines">The number of lines to write.</param>
-        <param name="rowBytes">To be added.</param>
+        <param name="rowBytes">The number of bytes per row.</param>
-        <summary>To be added.</summary>
+        <summary>Writes the next set of scanlines into the destination.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the number of lines successfully decoded.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>If number of lines successfully decoded is less than <paramref name="countLines" />, this will fill the remaining lines with a default value.</remarks>
      </Docs>
    </Member>
    <Member MemberName="GetValidSubset">
@ -767,9 +765,13 @@
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the y-coordinate of the next row to be returned by the scanline decoder.</summary>
-        <value>To be added.</value>
+        <value>
-        <remarks>To be added.</remarks>
+          <para></para>
        </value>
        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Origin">
@ -835,7 +837,7 @@
      <Docs>
        <summary>Gets the number of times to repeat, if this image is animated.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
          <para>For infinite repetition of frames, this will be -1.</para>
@ -854,9 +856,13 @@
        <ReturnType>SkiaSharp.SKCodecScanlineOrder</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the order in which scanlines will be returned by the scanline decoder.</summary>
-        <value>To be added.</value>
+        <value>
-        <remarks>To be added.</remarks>
+          <para></para>
        </value>
        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="SkipScanlines">
@ -873,10 +879,12 @@
        <Parameter Name="countLines" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="countLines">To be added.</param>
+        <param name="countLines">The number of scanlines to skip.</param>
-        <summary>To be added.</summary>
+        <summary>Skip the specified number of scanlines.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns <see langword="true" /> if the scanlines were successfully skipped, otherwise <see langword="false" /> on failure (incomplete input, the number of lines is less than zero, read all the lines).</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="StartIncrementalDecode">
@ -1015,10 +1023,10 @@
        <Parameter Name="info" Type="SkiaSharp.SKImageInfo" />
      </Parameters>
      <Docs>
-        <param name="info">To be added.</param>
+        <param name="info">The image information of the destination. If the dimensions do not match those of <see cref="P:SkiaSharp.SKCodec.Info" />, this implies a scale.</param>
-        <summary>To be added.</summary>
+        <summary>Prepare for a scanline decode.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns <see cref="F:SkiaSharp.SKCodecResult.Success" /> on success, or another value explaining the type of failure.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Not all codecs support this.</remarks>
      </Docs>
    </Member>
    <Member MemberName="StartScanlineDecode">
@ -1036,11 +1044,11 @@
        <Parameter Name="options" Type="SkiaSharp.SKCodecOptions" />
      </Parameters>
      <Docs>
-        <param name="info">To be added.</param>
+        <param name="info">The image information of the destination. If the dimensions do not match those of <see cref="P:SkiaSharp.SKCodec.Info" />, this implies a scale.</param>
-        <param name="options">To be added.</param>
+        <param name="options">The decoding options, including if memory is zero initialized and whether to decode a subset.</param>
-        <summary>To be added.</summary>
+        <summary>Prepare for a scanline decode with the specified options.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns <see cref="F:SkiaSharp.SKCodecResult.Success" /> on success, or another value explaining the type of failure.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Not all codecs support this.</remarks>
      </Docs>
    </Member>
    <Member MemberName="StartScanlineDecode">
@ -1060,13 +1068,13 @@
        <Parameter Name="colorTableCount" Type="System.Int32&amp;" RefType="ref" />
      </Parameters>
      <Docs>
-        <param name="info">To be added.</param>
+        <param name="info">The image information of the destination. If the dimensions do not match those of <see cref="P:SkiaSharp.SKCodec.Info" />, this implies a scale.</param>
-        <param name="options">To be added.</param>
+        <param name="options">The decoding options, including if memory is zero initialized and whether to decode a subset.</param>
-        <param name="colorTable">To be added.</param>
+        <param name="colorTable">The color table to use.</param>
-        <param name="colorTableCount">To be added.</param>
+        <param name="colorTableCount">The size of the color table.</param>
-        <summary>To be added.</summary>
+        <summary>Prepare for a scanline decode with the specified options.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns <see cref="F:SkiaSharp.SKCodecResult.Success" /> on success, or another value explaining the type of failure.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Not all codecs support this.</remarks>
      </Docs>
    </Member>
    <Member MemberName="StartScanlineDecode">
@ -1086,13 +1094,13 @@
        <Parameter Name="colorTableCount" Type="System.Int32&amp;" RefType="ref" />
      </Parameters>
      <Docs>
-        <param name="info">To be added.</param>
+        <param name="info">The image information of the destination. If the dimensions do not match those of <see cref="P:SkiaSharp.SKCodec.Info" />, this implies a scale.</param>
-        <param name="options">To be added.</param>
+        <param name="options">The decoding options, including if memory is zero initialized and whether to decode a subset.</param>
-        <param name="colorTable">To be added.</param>
+        <param name="colorTable">The pointer to the color table to use.</param>
-        <param name="colorTableCount">To be added.</param>
+        <param name="colorTableCount">The size of the color table.</param>
-        <summary>To be added.</summary>
+        <summary>Prepare for a scanline decode with the specified options.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns <see cref="F:SkiaSharp.SKCodecResult.Success" /> on success, or another value explaining the type of failure.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Not all codecs support this.</remarks>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/SkiaSharp/SKCodecFrameInfo.xml
+++ b/docs/en/SkiaSharp/SKCodecFrameInfo.xml
@ -49,10 +49,10 @@
      <Docs>
        <summary>Gets or sets the frame that this frame needs to be blended with, or -1.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
--- a/docs/en/SkiaSharp/SKCodecScanlineOrder.xml
+++ b/docs/en/SkiaSharp/SKCodecScanlineOrder.xml
@ -9,8 +9,8 @@
    <BaseTypeName>System.Enum</BaseTypeName>
  </Base>
  <Docs>
-    <summary>To be added.</summary>
+    <summary>The orders in which scanlines can be returned.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>These values are obtained through the <see cref="P:SkiaSharp.SKCodec.ScanlineOrder" /> property.</remarks>
  </Docs>
  <Members>
    <Member MemberName="BottomUp">
@ -24,7 +24,7 @@
        <ReturnType>SkiaSharp.SKCodecScanlineOrder</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates that the scanline decoder reliably outputs rows, but they will be returned in reverse order. The <see cref="P:SkiaSharp.SKCodec.NextScanline" /> property can be used to determine the actual y-coordinate of the next output row.</summary>
      </Docs>
    </Member>
    <Member MemberName="TopDown">
@ -38,7 +38,7 @@
        <ReturnType>SkiaSharp.SKCodecScanlineOrder</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Indicates that the image can be decoded reliably using the scanline decoder, and that rows will be output in the logical order.</summary>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/SkiaSharp/SKFontManager.xml
+++ b/docs/en/SkiaSharp/SKFontManager.xml
@ -10,8 +10,10 @@
  </Base>
  <Interfaces />
  <Docs>
-    <summary>To be added.</summary>
+    <summary>Manages a collection of fonts.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
      <para></para>
    </remarks>
  </Docs>
  <Members>
    <Member MemberName="Default">
@ -25,9 +27,13 @@
        <ReturnType>SkiaSharp.SKFontManager</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the default font manager.</summary>
-        <value>To be added.</value>
+        <value>
-        <remarks>To be added.</remarks>
+          <para></para>
        </value>
        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="Dispose">
@ -60,9 +66,13 @@
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the number of font families available.</summary>
-        <value>To be added.</value>
+        <value>
-        <remarks>To be added.</remarks>
+          <para></para>
        </value>
        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetFamilyName">
@ -79,10 +89,12 @@
        <Parameter Name="index" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="index">To be added.</param>
+        <param name="index">The index of the font family name to retrieve.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the font family name for the specified index.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the font family name.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetFontFamilies">
@ -97,9 +109,11 @@
      </ReturnValue>
      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
+        <summary>Returns all the font family names.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns an array of all the font family names.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -116,10 +130,12 @@
        <Parameter Name="character" Type="System.Char" />
      </Parameters>
      <Docs>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -136,10 +152,12 @@
        <Parameter Name="character" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -157,11 +175,13 @@
        <Parameter Name="character" Type="System.Char" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -179,11 +199,13 @@
        <Parameter Name="character" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -202,12 +224,12 @@
        <Parameter Name="character" Type="System.Char" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="bcp47">To be added.</param>
+        <param name="bcp47">The ISO 639, 15924, and 3166-1 code to use when searching, such as “ja” and “zh”.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Note that <paramref name="bcp47" /> is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here. The first item is the least significant fallback, and the last is the most significant. If no specified codes match, any font with the requested character will be matched.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -226,12 +248,12 @@
        <Parameter Name="character" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to try and use.</param>
-        <param name="bcp47">To be added.</param>
+        <param name="bcp47">The ISO 639, 15924, and 3166-1 code to use when searching, such as “ja” and “zh”.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Note that <paramref name="bcp47" /> is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here. The first item is the least significant fallback, and the last is the most significant. If no specified codes match, any font with the requested character will be matched.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -253,15 +275,15 @@
        <Parameter Name="character" Type="System.Char" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="weight">To be added.</param>
+        <param name="weight">The font weight to use when searching.</param>
-        <param name="width">To be added.</param>
+        <param name="width">The font width to use when searching.</param>
-        <param name="slant">To be added.</param>
+        <param name="slant">The font slant to use when searching.</param>
-        <param name="bcp47">To be added.</param>
+        <param name="bcp47">The ISO 639, 15924, and 3166-1 code to use when searching, such as “ja” and “zh”.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Note that <paramref name="bcp47" /> is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here. The first item is the least significant fallback, and the last is the most significant. If no specified codes match, any font with the requested character will be matched.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -283,15 +305,15 @@
        <Parameter Name="character" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="weight">To be added.</param>
+        <param name="weight">The font weight to use when searching.</param>
-        <param name="width">To be added.</param>
+        <param name="width">The font width to use when searching.</param>
-        <param name="slant">To be added.</param>
+        <param name="slant">The font slant to use when searching.</param>
-        <param name="bcp47">To be added.</param>
+        <param name="bcp47">The ISO 639, 15924, and 3166-1 code to use when searching, such as “ja” and “zh”.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Note that <paramref name="bcp47" /> is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here. The first item is the least significant fallback, and the last is the most significant. If no specified codes match, any font with the requested character will be matched.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MatchCharacter">
@ -313,15 +335,15 @@
        <Parameter Name="character" Type="System.Int32" />
      </Parameters>
      <Docs>
-        <param name="familyName">To be added.</param>
+        <param name="familyName">The family name to use when searching.</param>
-        <param name="weight">To be added.</param>
+        <param name="weight">The font weight to use when searching.</param>
-        <param name="width">To be added.</param>
+        <param name="width">The font width to use when searching.</param>
-        <param name="slant">To be added.</param>
+        <param name="slant">The font slant to use when searching.</param>
-        <param name="bcp47">To be added.</param>
+        <param name="bcp47">The ISO 639, 15924, and 3166-1 code to use when searching, such as “ja” and “zh”.</param>
-        <param name="character">To be added.</param>
+        <param name="character">The character to find a typeface for.</param>
-        <summary>To be added.</summary>
+        <summary>Use the system fallback to find a typeface for the given character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKTypeface" /> that containes the given character, or <see langword="null" /> if none was found.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>Note that <paramref name="bcp47" /> is a combination of ISO 639, 15924, and 3166-1 codes, so it is fine to just pass a ISO 639 here. The first item is the least significant fallback, and the last is the most significant. If no specified codes match, any font with the requested character will be matched.</remarks>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/SkiaSharp/SKMaskFilter.xml
+++ b/docs/en/SkiaSharp/SKMaskFilter.xml
@ -126,12 +126,14 @@
        <Parameter Name="flags" Type="SkiaSharp.SKBlurMaskFilterFlags" />
      </Parameters>
      <Docs>
-        <param name="blurStyle">To be added.</param>
+        <param name="blurStyle">The style of blurring.</param>
-        <param name="sigma">To be added.</param>
+        <param name="sigma">The standard deviation (greater than 0) of the Gaussian blur to apply.</param>
-        <param name="flags">To be added.</param>
+        <param name="flags">The flags to apply when blurring.</param>
-        <summary>To be added.</summary>
+        <summary>Creates a mask filter that applies a blur.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="CreateBlur">
@ -150,12 +152,14 @@
        <Parameter Name="occluder" Type="SkiaSharp.SKRect" />
      </Parameters>
      <Docs>
-        <param name="blurStyle">To be added.</param>
+        <param name="blurStyle">The style of blurring.</param>
-        <param name="sigma">To be added.</param>
+        <param name="sigma">The standard deviation (greater than 0) of the Gaussian blur to apply.</param>
-        <param name="occluder">To be added.</param>
+        <param name="occluder">The rect for which no pixels need be drawn (because it will be overdrawn with some opaque object).</param>
-        <summary>To be added.</summary>
+        <summary>Creates a mask filter that applies a blur.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="CreateBlur">
@ -175,13 +179,15 @@
        <Parameter Name="flags" Type="SkiaSharp.SKBlurMaskFilterFlags" />
      </Parameters>
      <Docs>
-        <param name="blurStyle">To be added.</param>
+        <param name="blurStyle">The style of blurring.</param>
-        <param name="sigma">To be added.</param>
+        <param name="sigma">The standard deviation (greater than 0) of the Gaussian blur to apply.</param>
-        <param name="occluder">To be added.</param>
+        <param name="occluder">The rect for which no pixels need be drawn (because it will be overdrawn with some opaque object).</param>
-        <param name="flags">To be added.</param>
+        <param name="flags">The flags to apply when blurring.</param>
-        <summary>To be added.</summary>
+        <summary>Creates a mask filter that applies a blur.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="CreateClip">
@ -285,7 +291,7 @@
        <summary>Creates a mask filter that applies an embossing effect.</summary>
        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -346,7 +352,7 @@
        <summary>Creates a mask filter that applies shadows for an occluding object.</summary>
        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -375,7 +381,7 @@
        <summary>Creates a mask filter that applies a table lookup on each of the alpha values in the mask.</summary>
        <returns>Returns the new <see cref="T:SkiaSharp.SKMaskFilter" />, or null on error.</returns>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
--- a/docs/en/SkiaSharp/SKPaint.xml
+++ b/docs/en/SkiaSharp/SKPaint.xml
@ -30,26 +30,13 @@
      <para>This shows three different paints, each set up to draw in a different style. Now the caller can intermix these paints freely, either using them as is, or modifying them as the drawing proceeds.</para>
      <para>Beyond simple attributes such as color, strokes, and text values, paints support effects. These are subclasses of different aspects of the drawing pipeline, that when referenced by a paint (each of them is reference-counted), are called to override some part of the drawing pipeline.</para>
      <para>For example, to draw using a gradient instead of a single color, assign a SkShader to the paint.</para>
-      <para>
+      <para></para>
        <example>
          <code lang="C#"><![CDATA[canvas.Clear (canvasColor);
 var start = new SKPoint (0, 0);
 var end = new SKPoint (256, 256);
 var colors = new SKColor[] { new SKColor (0, 0, 255), new SKColor (0, 255, 0) };
 var offsets = new float[] { 0, 1 };
 var shader = SKShader.CreateLinearGradient (start, end, colors, offsets, SKShaderTileMode.Clamp);
 var paint = new SKPaint {
    Shader = shader
 };
 canvas.DrawPaint (paint);]]></code>
        </example>
      </para>
      <para>
        <img href="gradient.png" />
      </para>
      <para>Now, anything drawn with that paint will be drawn with the gradient specified in the call to CreateLinearGradient.</para>
      <para>There are five types of effects that can be assigned to an <see cref="T:SkiaSharp.SKPaint" /> object:</para>
-      <para>
+      <para></para>
      <list type="bullet">
        <item>
          <term>BlendMode - Blend modes and Duff-Porter transfer modes.</term>
@ -67,7 +54,7 @@ canvas.DrawPaint (paint);]]></code>
          <term>Shader - Gradients and bitmap patterns.</term>
        </item>
      </list>
-      </para>
+      <para></para>
      <para></para>
      <para></para>
    </remarks>
@ -163,12 +150,14 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="measuredWidth" Type="System.Single&amp;" RefType="out" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to be measured.</param>
-        <param name="maxWidth">To be added.</param>
+        <param name="maxWidth">The maximum width. Only the subset of text whose accumulated widths are &lt;= <paramref name="maxWidth" /> are measured.</param>
-        <param name="measuredWidth">To be added.</param>
+        <param name="measuredWidth">The actual width of the measured text.</param>
-        <summary>To be added.</summary>
+        <summary>Measure the text, stopping early if the measured width exceeds <paramref name="maxWidth" />.</summary>
-        <returns>To be added.</returns>
+        <returns>Return the number of characters of text that were measured. </returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="BreakText">
@ -547,11 +536,13 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="points" Type="SkiaSharp.SKPoint[]" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to generate an outline for.</param>
-        <param name="points">To be added.</param>
+        <param name="points">The position to use for each glyph in the text.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the path (outline) for the specified text.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKPath" /> containing the outline of the text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetTextPath">
@ -600,12 +591,14 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="y" Type="System.Single" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to generate an outline for.</param>
-        <param name="x">To be added.</param>
+        <param name="x">The x-coordinate of the first glyph in the text.</param>
-        <param name="y">To be added.</param>
+        <param name="y">The y-coordinate of the first glyph in the text.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the path (outline) for the specified text.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the <see cref="T:SkiaSharp.SKPath" /> containing the outline of the text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetTextPath">
@ -749,10 +742,10 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets the image filter.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -799,10 +792,10 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets a value indicating whether auto-hinting is enabled.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -848,10 +841,10 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets a value indicating whether text is an embedded bitmap.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -871,10 +864,10 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets a value indicating whether text is linear.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
@ -922,7 +915,7 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets a value indicating whether the text is vertical or horizontal is enabled.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>If this property is set true, then advances are treated as Y values rather than X values, and <see cref="M:SkiaSharp.SKCanvas.DrawText" /> will place its glyphs vertically rather than horizontally.</remarks>
      </Docs>
@ -988,10 +981,10 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="text" Type="System.Byte[]" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to be measured.</param>
-        <summary>To be added.</summary>
+        <summary>Measures the specified text.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the width of the text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>This will return the vertical measure if this is vertical text, in which case the returned value should be treated has a height instead of a width.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MeasureText">
@ -1015,8 +1008,8 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="text" Type="System.String" />
      </Parameters>
      <Docs>
-        <param name="text">The text to be measured</param>
+        <param name="text">The text to be measured.</param>
-        <summary>Measures the text.</summary>
+        <summary>Measures the specified text.</summary>
        <returns>Returns the width of the text.</returns>
        <remarks>This will return the vertical measure if this is vertical text, in which case the returned value should be treated has a height instead of a width.</remarks>
      </Docs>
@ -1036,11 +1029,11 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="bounds" Type="SkiaSharp.SKRect&amp;" RefType="ref" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to be measured.</param>
-        <param name="bounds">To be added.</param>
+        <param name="bounds">The bounds of the text relative to (0, 0)</param>
-        <summary>To be added.</summary>
+        <summary>Measures the specified text.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the width of the text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>This will return the vertical measure if this is vertical text, in which case the returned value should be treated has a height instead of a width.</remarks>
      </Docs>
    </Member>
    <Member MemberName="MeasureText">
@ -1067,7 +1060,7 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <param name="buffer">The pointer to a region holding text encoded using the encoding specified in <see cref="P:SkiaSharp.SKPaint.TextEncoding" /> format.</param>
        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
-        <summary>Measures the UTF-8 encoded text.</summary>
+        <summary>Measures the specified UTF-8 encoded text.</summary>
        <returns>Returns the width of the text.</returns>
        <remarks>The <paramref name="buffer" /> parameter is a pointer to a region in memory that contains text encoded in the <see cref="P:SkiaSharp.SKPaint.TextEncoding" /> format.   This only consumes up to <paramref name="length" /> bytes from the buffer.</remarks>
      </Docs>
@ -1094,9 +1087,9 @@ canvas.DrawPaint (paint);]]></code>
        <Parameter Name="bounds" Type="SkiaSharp.SKRect&amp;" RefType="ref" />
      </Parameters>
      <Docs>
-        <param name="text">The text to be measured</param>
+        <param name="text">The text to be measured.</param>
        <param name="bounds">The bounds of the text relative to (0, 0)</param>
-        <summary>Measures the text</summary>
+        <summary>Measures the specified text.</summary>
        <returns>Returns the width of the text.</returns>
        <remarks>This will return the vertical measure if this is vertical text, in which case the returned value should be treated has a height instead of a width.</remarks>
      </Docs>
@ -1127,7 +1120,7 @@ canvas.DrawPaint (paint);]]></code>
        <param name="buffer">The pointer to a region holding text encoded using the encoding specified in <see cref="P:SkiaSharp.SKPaint.TextEncoding" /> format.</param>
        <param name="length">The number of bytes to read from the <paramref name="buffer." /></param>
        <param name="bounds">The bounds of the text relative to (0, 0)</param>
-        <summary>Measures the UTF-8 encoded text.</summary>
+        <summary>Measures the specified UTF-8 encoded text.</summary>
        <returns>Returns the width of the text.</returns>
        <remarks>
          <para>This will return the vertical measure if this is vertical text, in which case the returned value should be treated has a height instead of a width.</para>
@ -1347,10 +1340,10 @@ canvas.DrawPaint (paint);]]></code>
      <Docs>
        <summary>Gets or sets a value indicating whether to use subpixel text positioning.</summary>
        <value>
-          <para />
+          <para></para>
        </value>
        <remarks>
-          <para />
+          <para></para>
        </remarks>
      </Docs>
    </Member>
--- a/docs/en/SkiaSharp/StringUtilities.xml
+++ b/docs/en/SkiaSharp/StringUtilities.xml
@ -10,8 +10,10 @@
  </Base>
  <Interfaces />
  <Docs>
-    <summary>To be added.</summary>
+    <summary>Various utility methods for when working with strings and text.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
      <para></para>
    </remarks>
  </Docs>
  <Members>
    <Member MemberName="GetEncodedText">
@ -29,11 +31,13 @@
        <Parameter Name="encoding" Type="SkiaSharp.SKTextEncoding" />
      </Parameters>
      <Docs>
-        <param name="text">To be added.</param>
+        <param name="text">The text to encode.</param>
-        <param name="encoding">To be added.</param>
+        <param name="encoding">The encoding to use.</param>
-        <summary>To be added.</summary>
+        <summary>Encodes the specified string using the encoding as a byte array.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the encoded text as a byte array.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetString">
@ -51,11 +55,13 @@
        <Parameter Name="encoding" Type="SkiaSharp.SKTextEncoding" />
      </Parameters>
      <Docs>
-        <param name="data">To be added.</param>
+        <param name="data">The bytes representing text.</param>
-        <param name="encoding">To be added.</param>
+        <param name="encoding">The encoding to use.</param>
-        <summary>To be added.</summary>
+        <summary>Decodes the specified bytes as a string.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the decoded text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetString">
@ -74,12 +80,14 @@
        <Parameter Name="encoding" Type="SkiaSharp.SKTextEncoding" />
      </Parameters>
      <Docs>
-        <param name="data">To be added.</param>
+        <param name="data">The pointer to the bytes representing text.</param>
-        <param name="dataLength">To be added.</param>
+        <param name="dataLength">The number of bytes to decode.</param>
-        <param name="encoding">To be added.</param>
+        <param name="encoding">The encoding to use.</param>
-        <summary>To be added.</summary>
+        <summary>Decodes the specified bytes as a string.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the decoded text.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="GetUnicodeCharacterCode">
@ -97,11 +105,13 @@
        <Parameter Name="encoding" Type="SkiaSharp.SKTextEncoding" />
      </Parameters>
      <Docs>
-        <param name="character">To be added.</param>
+        <param name="character">The character to get the unicode character code.</param>
-        <param name="encoding">To be added.</param>
+        <param name="encoding">The encoding of the string.</param>
-        <summary>To be added.</summary>
+        <summary>Returns the Unicode character code for the specified character.</summary>
-        <returns>To be added.</returns>
+        <returns>Returns the Unicode character code.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
          <para />
        </remarks>
      </Docs>
    </Member>
  </Members>