diff --git a/src/Humanizer/Bytes/ByteSize.cs b/src/Humanizer/Bytes/ByteSize.cs
index e09d9783b..253f749d5 100644
--- a/src/Humanizer/Bytes/ByteSize.cs
+++ b/src/Humanizer/Bytes/ByteSize.cs
@@ -27,6 +27,7 @@ namespace Humanizer.Bytes
     /// <summary>
     /// Represents a byte size value.
     /// </summary>
+#pragma warning disable 1591
     public struct ByteSize : IComparable<ByteSize>, IEquatable<ByteSize>
     {
         public static readonly ByteSize MinValue = FromBits(long.MinValue);
@@ -384,3 +385,4 @@ public static ByteSize Parse(string s)
         }
     }
 }
+#pragma warning restore 1591
diff --git a/src/Humanizer/EnumHumanizeExtensions.cs b/src/Humanizer/EnumHumanizeExtensions.cs
index 4fd2327ce..b4891c463 100644
--- a/src/Humanizer/EnumHumanizeExtensions.cs
+++ b/src/Humanizer/EnumHumanizeExtensions.cs
@@ -4,6 +4,9 @@
 
 namespace Humanizer
 {
+    /// <summary>
+    /// Contains extension methods for humanizing Enums
+    /// </summary>
     public static class EnumHumanizeExtensions
     {
         private static readonly Func<PropertyInfo, bool> DescriptionProperty = p => p.Name == "Description" && p.PropertyType == typeof (string);
diff --git a/src/Humanizer/Humanizer.csproj b/src/Humanizer/Humanizer.csproj
index 48a21ac9b..a9ad7e493 100644
--- a/src/Humanizer/Humanizer.csproj
+++ b/src/Humanizer/Humanizer.csproj
@@ -27,7 +27,7 @@
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
     <DocumentationFile>bin\Debug\Humanizer.xml</DocumentationFile>
-    <NoWarn>1591</NoWarn>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
     <DebugType>pdbonly</DebugType>
@@ -37,7 +37,7 @@
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
     <DocumentationFile>bin\Release\Humanizer.xml</DocumentationFile>
-    <NoWarn>1591</NoWarn>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'ReleaseNET35|AnyCPU'">
     <OutputPath>bin\Release\</OutputPath>
@@ -204,4 +204,4 @@
   <Target Name="AfterBuild">
   </Target>
   -->
-</Project>
\ No newline at end of file
+</Project>
diff --git a/src/Humanizer/Localisation/Formatters/DefaultFormatter.cs b/src/Humanizer/Localisation/Formatters/DefaultFormatter.cs
index 727c157d4..37eca6839 100644
--- a/src/Humanizer/Localisation/Formatters/DefaultFormatter.cs
+++ b/src/Humanizer/Localisation/Formatters/DefaultFormatter.cs
@@ -6,28 +6,41 @@
     public class DefaultFormatter : IFormatter
     {
         /// <summary>
-        /// Now!
+        /// Now
         /// </summary>
-        /// <returns>Time expressed in words</returns>
+        /// <returns>Returns Now</returns>
         public virtual string DateHumanize_Now()
         {
             return GetResourceForDate(TimeUnit.Millisecond, Tense.Past, 0);
         }
 
+        /// <summary>
+        /// Returns the string representation of the provided DateTime
+        /// </summary>
+        /// <param name="timeUnit"></param>
+        /// <param name="timeUnitTense"></param>
+        /// <param name="unit"></param>
+        /// <returns></returns>
         public virtual string DateHumanize(TimeUnit timeUnit, Tense timeUnitTense, int unit)
         {
             return GetResourceForDate(timeUnit, timeUnitTense, unit);
         }
 
         /// <summary>
-        /// In NO time!
+        /// 0 seconds
         /// </summary>
-        /// <returns>Time expressed in words</returns>
+        /// <returns>Returns 0 seconds as the string representation of Zero TimeSpan</returns>
         public virtual string TimeSpanHumanize_Zero()
         {
             return GetResourceForTimeSpan(TimeUnit.Millisecond, 0);
         }
 
+        /// <summary>
+        /// Returns the string representation of the provided TimeSpan
+        /// </summary>
+        /// <param name="timeUnit"></param>
+        /// <param name="unit"></param>
+        /// <returns></returns>
         public virtual string TimeSpanHumanize(TimeUnit timeUnit, int unit)
         {
             return GetResourceForTimeSpan(timeUnit, unit);
@@ -45,21 +58,43 @@ private string GetResourceForTimeSpan(TimeUnit unit, int count)
             return count == 1 ? Format(resourceKey) : Format(resourceKey, count);
         }
 
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="resourceKey"></param>
+        /// <returns></returns>
         protected virtual string Format(string resourceKey)
         {
             return Resources.GetResource(GetResourceKey(resourceKey));
         }
 
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="resourceKey"></param>
+        /// <param name="number"></param>
+        /// <returns></returns>
         protected virtual string Format(string resourceKey, int number)
         {
             return Resources.GetResource(GetResourceKey(resourceKey, number)).FormatWith(number);
         }
 
+        /// <summary>
+        /// Override this method if your locale has complex rules around multiple units; e.g. Arabic, Russian
+        /// </summary>
+        /// <param name="resourceKey">The resource key that's being in formatting</param>
+        /// <param name="number">The number of the units being used in formatting</param>
+        /// <returns></returns>
         protected virtual string GetResourceKey(string resourceKey, int number)
         {
             return resourceKey;
         }
 
+        /// <summary>
+        /// 
+        /// </summary>
+        /// <param name="resourceKey"></param>
+        /// <returns></returns>
         protected virtual string GetResourceKey(string resourceKey)
         {
             return resourceKey;
diff --git a/src/Humanizer/Localisation/Formatters/IFormatter.cs b/src/Humanizer/Localisation/Formatters/IFormatter.cs
index b591d6cfa..887209658 100644
--- a/src/Humanizer/Localisation/Formatters/IFormatter.cs
+++ b/src/Humanizer/Localisation/Formatters/IFormatter.cs
@@ -7,10 +7,33 @@
     /// </summary>
     public interface IFormatter
     {
+        /// <summary>
+        /// Now
+        /// </summary>
+        /// <returns>Returns Now</returns>
         string DateHumanize_Now();
+
+        /// <summary>
+        /// Returns the string representation of the provided DateTime
+        /// </summary>
+        /// <param name="timeUnit"></param>
+        /// <param name="timeUnitTense"></param>
+        /// <param name="unit"></param>
+        /// <returns></returns>
         string DateHumanize(TimeUnit timeUnit, Tense timeUnitTense, int unit);
-        
+
+        /// <summary>
+        /// 0 seconds
+        /// </summary>
+        /// <returns>Returns 0 seconds as the string representation of Zero TimeSpan</returns>
         string TimeSpanHumanize_Zero();
+
+        /// <summary>
+        /// Returns the string representation of the provided TimeSpan
+        /// </summary>
+        /// <param name="timeUnit"></param>
+        /// <param name="unit"></param>
+        /// <returns></returns>
         string TimeSpanHumanize(TimeUnit timeUnit, int unit);
     }
 }
diff --git a/src/Humanizer/Localisation/ResourceKeys.Common.cs b/src/Humanizer/Localisation/ResourceKeys.Common.cs
index 1774b1052..5f995cb6d 100644
--- a/src/Humanizer/Localisation/ResourceKeys.Common.cs
+++ b/src/Humanizer/Localisation/ResourceKeys.Common.cs
@@ -2,6 +2,9 @@
 
 namespace Humanizer.Localisation
 {
+    /// <summary>
+    /// 
+    /// </summary>
     public partial class ResourceKeys
     {
         private const string Single = "Single";
diff --git a/src/Humanizer/Localisation/ResourceKeys.DateHumanize.cs b/src/Humanizer/Localisation/ResourceKeys.DateHumanize.cs
index 3c49856fd..ee91374f9 100644
--- a/src/Humanizer/Localisation/ResourceKeys.DateHumanize.cs
+++ b/src/Humanizer/Localisation/ResourceKeys.DateHumanize.cs
@@ -2,6 +2,9 @@
 {
     public partial class ResourceKeys
     {
+        /// <summary>
+        /// Encapsulates the logic required to get the resource keys for DateTime.Humanize
+        /// </summary>
         public static class DateHumanize
         {
             /// <summary>
diff --git a/src/Humanizer/Localisation/ResourceKeys.TimeSpanHumanize.cs b/src/Humanizer/Localisation/ResourceKeys.TimeSpanHumanize.cs
index 85ef1d74a..321e961a3 100644
--- a/src/Humanizer/Localisation/ResourceKeys.TimeSpanHumanize.cs
+++ b/src/Humanizer/Localisation/ResourceKeys.TimeSpanHumanize.cs
@@ -2,6 +2,9 @@
 {
     public partial class ResourceKeys
     {
+        /// <summary>
+        /// Encapsulates the logic required to get the resource keys for TimeSpan.Humanize
+        /// </summary>
         public static class TimeSpanHumanize
         {
             /// <summary>
diff --git a/src/Humanizer/Localisation/TimeUnit.cs b/src/Humanizer/Localisation/TimeUnit.cs
index 86c4a56b4..e8941b3c1 100644
--- a/src/Humanizer/Localisation/TimeUnit.cs
+++ b/src/Humanizer/Localisation/TimeUnit.cs
@@ -3,6 +3,7 @@
     /// <summary>
     /// Units of time.
     /// </summary>
+#pragma warning disable 1591
     public enum TimeUnit
     {
         Millisecond,
@@ -14,4 +15,5 @@ public enum TimeUnit
         Month,
         Year
     }
+#pragma warning restore 1591
 }
\ No newline at end of file
diff --git a/src/Humanizer/NoMatchFoundException.cs b/src/Humanizer/NoMatchFoundException.cs
index 19dafef78..30614308a 100644
--- a/src/Humanizer/NoMatchFoundException.cs
+++ b/src/Humanizer/NoMatchFoundException.cs
@@ -5,6 +5,7 @@ namespace Humanizer
     /// <summary>
     /// This is thrown on String.DehumanizeTo enum when the provided string cannot be mapped to the target enum
     /// </summary>
+#pragma warning disable 1591
     public class NoMatchFoundException : Exception
     {
         public NoMatchFoundException()
@@ -21,4 +22,5 @@ public NoMatchFoundException(string message, Exception inner)
         {
         }
     }
+#pragma warning restore 1591
 }
\ No newline at end of file
diff --git a/src/Humanizer/RomanNumeralExtensions.cs b/src/Humanizer/RomanNumeralExtensions.cs
index a37c85a45..d6e72b772 100644
--- a/src/Humanizer/RomanNumeralExtensions.cs
+++ b/src/Humanizer/RomanNumeralExtensions.cs
@@ -6,6 +6,9 @@
 
 namespace Humanizer
 {
+    /// <summary>
+    /// Contains extension methods for changing a number to Roman representation (ToRoman) and from Roman representation back to the number (FromRoman)
+    /// </summary>
     public static class RomanNumeralExtensions
     {
         private const int NumberOfRomanNumeralMaps = 13;
diff --git a/src/Humanizer/Transformer/To.cs b/src/Humanizer/Transformer/To.cs
index fb0cef5cd..ad24f88f6 100644
--- a/src/Humanizer/Transformer/To.cs
+++ b/src/Humanizer/Transformer/To.cs
@@ -18,6 +18,12 @@ public static string Transform(this string input, params IStringTransformer[] tr
             return transformers.Aggregate(input, (current, stringTransformer) => stringTransformer.Transform(current));
         }
 
+        /// <summary>
+        /// Changes string to title case
+        /// </summary>
+        /// <example>
+        /// "INvalid caSEs arE corrected" -> "Invalid Cases Are Corrected"
+        /// </example>
         public static IStringTransformer TitleCase
         {
             get
@@ -26,6 +32,12 @@ public static IStringTransformer TitleCase
             }
         }
 
+        /// <summary>
+        /// Changes the string to lower case
+        /// </summary>
+        /// <example>
+        /// "Sentence casing" -> "sentence casing"
+        /// </example>
         public static IStringTransformer LowerCase
         {
             get
@@ -34,6 +46,12 @@ public static IStringTransformer LowerCase
             }
         }
 
+        /// <summary>
+        /// Changes the string to upper case
+        /// </summary>
+        /// <example>
+        /// "lower case statement" -> "LOWER CASE STATEMENT"
+        /// </example>
         public static IStringTransformer UpperCase
         {
             get
@@ -42,6 +60,12 @@ public static IStringTransformer UpperCase
             }
         }
 
+        /// <summary>
+        /// Changes the string to sentence case
+        /// </summary>
+        /// <example>
+        /// "lower case statement" -> "Lower case statement"
+        /// </example>
         public static IStringTransformer SentenceCase
         {
             get