xml doc fixes

src/ImageSharp.Drawing.Paths/DrawBeziers.cs

@@ -24,14 +24,12 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -42,11 +40,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -57,11 +55,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -72,14 +70,12 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -90,13 +86,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path with the supplied pen
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -107,10 +101,10 @@ namespace ImageSharp
         /// Draws the provided Points as an open Bezier path with the supplied pen
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawBeziers<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/DrawLines.cs

@@ -22,14 +22,12 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -40,11 +38,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -55,11 +53,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -70,14 +68,12 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path at the provided thickness with the supplied brush
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -88,13 +84,11 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path with the supplied pen
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -105,10 +99,10 @@ namespace ImageSharp
         /// Draws the provided Points as an open Linear path with the supplied pen
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawLines<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/DrawPath.cs

@@ -22,13 +22,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, IPath path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -39,12 +37,10 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, IPath path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -55,14 +51,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, IPath path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -73,13 +67,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, IPath path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -90,14 +82,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, IPath path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -108,13 +98,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, IPath path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/DrawPolygon.cs

@@ -22,14 +22,12 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -40,11 +38,11 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -55,11 +53,11 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -70,14 +68,12 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, TColor color, float thickness, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -88,12 +84,10 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided Pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -104,13 +98,11 @@ namespace ImageSharp
         /// Draws the provided Points as a closed Linear Polygon with the provided Pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> DrawPolygon<TColor>(this Image<TColor> source, IPen<TColor> pen, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/DrawRectangle.cs

@@ -23,13 +23,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, Rectangle shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -40,10 +38,10 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, Rectangle shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -54,14 +52,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Rectangle shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -72,11 +68,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Rectangle shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -87,14 +83,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, Rectangle shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -105,11 +99,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, Rectangle shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/DrawShape.cs

@@ -22,13 +22,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, IShape shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -39,10 +37,10 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, IShape shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -53,14 +51,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, IShape shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -71,11 +67,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, IShape shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -86,14 +82,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, IShape shape, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -104,11 +98,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, IShape shape)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/FillPaths.cs

@@ -22,13 +22,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="path">The shape.</param>
         /// <param name="options">The graphics options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, IPath path, GraphicsOptions options)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -39,12 +37,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, IPath path)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -55,13 +51,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, IPath path, GraphicsOptions options)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -72,12 +66,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, IPath path)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/FillPolygon.cs

@@ -22,13 +22,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of a Linear polygon described by the points
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> FillPolygon<TColor>(this Image<TColor> source, IBrush<TColor> brush, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -39,10 +37,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of a Linear polygon described by the points
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> FillPolygon<TColor>(this Image<TColor> source, IBrush<TColor> brush, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -53,13 +51,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of a Linear polygon described by the points
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="points">The points.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> FillPolygon<TColor>(this Image<TColor> source, TColor color, Vector2[] points, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -70,10 +66,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of a Linear polygon described by the points
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="points">The points.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> FillPolygon<TColor>(this Image<TColor> source, TColor color, Vector2[] points)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/FillRectangle.cs

@@ -20,13 +20,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, Rectangle shape, GraphicsOptions options)
             where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -37,10 +35,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, Rectangle shape)
             where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -51,13 +49,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, Rectangle shape, GraphicsOptions options)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -68,10 +64,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, Rectangle shape)
             where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/FillShape.cs

@@ -22,13 +22,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The graphics options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, IShape shape, GraphicsOptions options)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -39,10 +37,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush, IShape shape)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -53,13 +51,11 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="shape">The shape.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, IShape shape, GraphicsOptions options)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -70,10 +66,10 @@ namespace ImageSharp
         /// Flood fills the image in the shape of the provided polygon with the specified brush..
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="shape">The shape.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color, IShape shape)
           where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing.Paths/PointInfoExtensions.cs

@@ -13,7 +13,7 @@ namespace ImageSharp.Drawing
         /// <summary>
         /// Converts a <see cref="SixLabors.Shapes.PointInfo"/> to an ImageSharp <see cref="PointInfo"/>.
         /// </summary>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <returns>A <see cref="PointInfo"/> representation of this <see cref="SixLabors.Shapes.PointInfo"/></returns>
         public static PointInfo Convert(this SixLabors.Shapes.PointInfo source)
         {

src/ImageSharp.Drawing.Paths/RectangleExtensions.cs

@@ -22,7 +22,7 @@ namespace ImageSharp.Drawing.Processors
         /// <summary>
         /// Converts a Shaper2D <see cref="SixLabors.Shapes.Rectangle"/> to an ImageSharp <see cref="Rectangle"/> by creating a <see cref="Rectangle"/> the entirely surrounds the source.
         /// </summary>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <returns>A <see cref="Rectangle"/> representation of this <see cref="SixLabors.Shapes.Rectangle"/></returns>
         public static Rectangle Convert(this SixLabors.Shapes.Rectangle source)
         {

src/ImageSharp.Drawing.Paths/ShapePath.cs

@@ -64,32 +64,13 @@ namespace ImageSharp.Drawing
         /// </value>
         public ImmutableArray<IPath> Paths { get; }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Gets the maximum number of intersections to could be returned.
-        /// </summary>
-        /// <value>
-        /// The maximum intersections.
-        /// </value>
         public override int MaxIntersections => this.shape.MaxIntersections;
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Gets the bounds.
-        /// </summary>
-        /// <value>
-        /// The bounds.
-        /// </value>
         public override Rectangle Bounds { get; }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Scans the X axis for intersections.
-        /// </summary>
-        /// <param name="x">The x.</param>
-        /// <param name="buffer">The buffer.</param>
-        /// <param name="length">The length.</param>
-        /// <param name="offset">The offset.</param>
-        /// <returns>
-        /// The number of intersections found.
-        /// </returns>
         public override int ScanX(int x, float[] buffer, int length, int offset)
         {
             Vector2 start = new Vector2(x, this.Bounds.Top - 1);
@@ -117,16 +98,7 @@ namespace ImageSharp.Drawing
             }
         }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Scans the Y axis for intersections.
-        /// </summary>
-        /// <param name="y">The position along the y axis to find intersections.</param>
-        /// <param name="buffer">The buffer.</param>
-        /// <param name="length">The length.</param>
-        /// <param name="offset">The offset.</param>
-        /// <returns>
-        /// The number of intersections found.
-        /// </returns>
         public override int ScanY(int y, float[] buffer, int length, int offset)
         {
             Vector2 start = new Vector2(float.MinValue, y);
@@ -154,12 +126,7 @@ namespace ImageSharp.Drawing
             }
         }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Gets the point information for the specified x and y location.
-        /// </summary>
-        /// <param name="x">The x.</param>
-        /// <param name="y">The y.</param>
-        /// <returns>Information about the the point</returns>
         public override PointInfo GetPointInfo(int x, int y)
         {
             Vector2 point = new Vector2(x, y);

src/ImageSharp.Drawing.Paths/ShapeRegion.cs

@@ -44,32 +44,13 @@ namespace ImageSharp.Drawing
         /// </summary>
         public IShape Shape { get; }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Gets the maximum number of intersections to could be returned.
-        /// </summary>
-        /// <value>
-        /// The maximum intersections.
-        /// </value>
         public override int MaxIntersections => this.Shape.MaxIntersections;
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Gets the bounds.
-        /// </summary>
-        /// <value>
-        /// The bounds.
-        /// </value>
         public override Rectangle Bounds { get; }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Scans the X axis for intersections.
-        /// </summary>
-        /// <param name="x">The x.</param>
-        /// <param name="buffer">The buffer.</param>
-        /// <param name="length">The length.</param>
-        /// <param name="offset">The offset.</param>
-        /// <returns>
-        /// The number of intersections found.
-        /// </returns>
         public override int ScanX(int x, float[] buffer, int length, int offset)
         {
             Vector2 start = new Vector2(x, this.Bounds.Top - 1);
@@ -97,16 +78,7 @@ namespace ImageSharp.Drawing
             }
         }
 
-        /// <summary>
+        /// <inheritdoc/>
-        /// Scans the Y axis for intersections.
-        /// </summary>
-        /// <param name="y">The position along the y axis to find intersections.</param>
-        /// <param name="buffer">The buffer.</param>
-        /// <param name="length">The length.</param>
-        /// <param name="offset">The offset.</param>
-        /// <returns>
-        /// The number of intersections found.
-        /// </returns>
         public override int ScanY(int y, float[] buffer, int length, int offset)
         {
             Vector2 start = new Vector2(float.MinValue, y);

src/ImageSharp.Drawing/DrawPath.cs

@@ -21,13 +21,11 @@ namespace ImageSharp
         /// Draws the outline of the region with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, Drawable path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -38,12 +36,10 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided pen.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="pen">The pen.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IPen<TColor> pen, Drawable path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -54,14 +50,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Drawable path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -72,13 +66,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, IBrush<TColor> brush, float thickness, Drawable path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -89,14 +81,12 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
         /// <param name="options">The options.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, Drawable path, GraphicsOptions options)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -107,13 +97,11 @@ namespace ImageSharp
         /// Draws the outline of the polygon with the provided brush at the provided thickness.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="thickness">The thickness.</param>
         /// <param name="path">The path.</param>
-        /// <returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
-        /// The Image
-        /// </returns>
         public static Image<TColor> Draw<TColor>(this Image<TColor> source, TColor color, float thickness, Drawable path)
            where TColor : struct, IPackedPixel, IEquatable<TColor>
         {

src/ImageSharp.Drawing/Drawable.cs

@@ -13,17 +13,11 @@ namespace ImageSharp.Drawing
         /// <summary>
         /// Gets the maximum number of intersections to could be returned.
         /// </summary>
-        /// <value>
-        /// The maximum intersections.
-        /// </value>
         public abstract int MaxIntersections { get; }
 
         /// <summary>
         /// Gets the bounds.
         /// </summary>
-        /// <value>
-        /// The bounds.
-        /// </value>
         public abstract Rectangle Bounds { get; }
 
         /// <summary>

src/ImageSharp.Drawing/FillRegion.cs

@@ -20,9 +20,9 @@ namespace ImageSharp
         /// Flood fills the image with the specified brush.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
-        /// <param name="brush">The brush.</param>
+        /// <param name="brush">The details how to fill the region of interest.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, IBrush<TColor> brush)
             where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -33,9 +33,9 @@ namespace ImageSharp
         /// Flood fills the image with the specified color.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
-        /// <returns>The Image</returns>
+        /// <returns>The <see cref="Image{TColor}"/>.</returns>
         public static Image<TColor> Fill<TColor>(this Image<TColor> source, TColor color)
             where TColor : struct, IPackedPixel, IEquatable<TColor>
         {
@@ -46,7 +46,7 @@ namespace ImageSharp
         /// Flood fills the image with in the region with the specified brush.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="region">The region.</param>
         /// <param name="options">The graphics options.</param>
@@ -63,7 +63,7 @@ namespace ImageSharp
         /// Flood fills the image with in the region with the specified brush.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="brush">The brush.</param>
         /// <param name="region">The region.</param>
         /// <returns>
@@ -79,7 +79,7 @@ namespace ImageSharp
         /// Flood fills the image with in the region with the specified color.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="region">The region.</param>
         /// <param name="options">The options.</param>
@@ -96,7 +96,7 @@ namespace ImageSharp
         /// Flood fills the image with in the region with the specified color.
         /// </summary>
         /// <typeparam name="TColor">The type of the color.</typeparam>
-        /// <param name="source">The source.</param>
+        /// <param name="source">The image this method extends.</param>
         /// <param name="color">The color.</param>
         /// <param name="region">The region.</param>
         /// <returns>

src/ImageSharp.Drawing/Processors/DrawPathProcessor.cs

@@ -28,12 +28,12 @@ namespace ImageSharp.Drawing.Processors
         /// <summary>
         /// Initializes a new instance of the <see cref="DrawPathProcessor{TColor}" /> class.
         /// </summary>
-        /// <param name="pen">The pen.</param>
+        /// <param name="pen">The details how to draw the outline/path.</param>
-        /// <param name="region">The region.</param>
+        /// <param name="drawable">The details of the paths and outlines to draw.</param>
-        /// <param name="options">The options.</param>
+        /// <param name="options">The drawing configuration options.</param>
-        public DrawPathProcessor(IPen<TColor> pen, Drawable region, GraphicsOptions options)
+        public DrawPathProcessor(IPen<TColor> pen, Drawable drawable, GraphicsOptions options)
         {
-            this.Path = region;
+            this.Path = drawable;
             this.Pen = pen;
             this.Options = options;
         }

src/ImageSharp.Drawing/Processors/FillRegionProcessor.cs

@@ -26,9 +26,9 @@ namespace ImageSharp.Drawing.Processors
         /// <summary>
         /// Initializes a new instance of the <see cref="FillRegionProcessor{TColor}" /> class.
         /// </summary>
-        /// <param name="brush">The brush.</param>
+        /// <param name="brush">The details how to fill the region of interest.</param>
-        /// <param name="region">The region.</param>
+        /// <param name="region">The region of interest to be filled.</param>
-        /// <param name="options">The options.</param>
+        /// <param name="options">The configuration options.</param>
         public FillRegionProcessor(IBrush<TColor> brush, Region region, GraphicsOptions options)
         {
             this.Region = region;

src/ImageSharp.Drawing/Region.cs

@@ -13,23 +13,20 @@ namespace ImageSharp.Drawing
         /// <summary>
         /// Gets the maximum number of intersections to could be returned.
         /// </summary>
-        /// <value>
-        /// The maximum intersections.
-        /// </value>
         public abstract int MaxIntersections { get; }
 
         /// <summary>
-        /// Gets the bounds.
+        /// Gets the bounding box that entirly surrounds this region.
         /// </summary>
-        /// <value>
+        /// <remarks>
-        /// The bounds.
+        /// This should always contains all possible points returned from eather <see cref="ScanX(int, float[], int, int)"/> or <see cref="ScanY(int, float[], int, int)"/>.
-        /// </value>
+        /// </remarks>
         public abstract Rectangle Bounds { get; }
 
         /// <summary>
         /// Scans the X axis for intersections.
         /// </summary>
-        /// <param name="x">The x.</param>
+        /// <param name="x">The position along the X axies to find intersections.</param>
         /// <param name="buffer">The buffer.</param>
         /// <param name="length">The length.</param>
         /// <param name="offset">The offset.</param>