Added comments to the code

src/YamlMap/Serialization/SerializerExtensions.cs

@@ -0,0 +1,29 @@
+using System.Linq;
+
+namespace YamlMap.Serialization
+{
+	internal static class SerializerExtensions
+    {
+        private static readonly char[] SpecialChars = new[] { ':', '[', ']' };
+
+        /// <summary>
+        /// Convert a object to a string that is used for serialization
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        public static string ToSerializeableString(this object value)
+        {
+            if (value == null)
+            {
+                return null;
+            }
+
+            if (value is string s && SpecialChars.Any(c => s.Contains(c)))
+            {
+                value = $"'{s}'";
+            }
+
+            return value.ToString();
+        }
+    }
+}

src/YamlMap/Serialization/TokenDeserializer.cs

@@ -4,23 +4,37 @@
 
 namespace YamlMap.Serialization
 {
+    /// <summary>
+    /// Deserializer
+    /// </summary>
     public class TokenDeserializer : ITokenDeserializer
     {
-        //private readonly PropertyMapper _mapper;
         private readonly object _item;
         private readonly IToken _token;
         private readonly Type _type;
 
+        /// <summary>
+        /// Creates a new deserializer
+        /// </summary>
+        /// <param name="type"></param>
+        /// <param name="token"></param>
         public TokenDeserializer(Type type, IToken token)
         {
-            //_mapper = new PropertyMapper(type);
             _item = type.CreateInstance(token);
             _token = token;
             _type = type;
         }
 
+        /// <summary>
+        /// Gets the instance that is created
+        /// </summary>
         public object Node => _item;
 
+        /// <summary>
+        /// Deserialize a <see cref="IToken"/>
+        /// </summary>
+        /// <param name="token"></param>
+        /// <exception cref="InvalidConfigurationException"></exception>
         public void Deserialize(IToken token)
         {
             var mapper = MapperFactory.GetObjectMapper(Node, _type);
@@ -54,6 +68,9 @@ public void Deserialize(IToken token)
             property.SetValue(Node, child.Node, null);
         }
 
+        /// <summary>
+        /// Deserialize all child tokens
+        /// </summary>
         public void DeserializeChildren()
         {
             // refactor the line to be parsed as property

src/YamlMap/Serialization/TokenSerializer.cs

@@ -6,10 +6,17 @@
 
 namespace YamlMap.Serialization
 {
+    /// <summary>
+    /// Serializer that creates tokens of objects
+    /// </summary>
     public class TokenSerializer
     {
-
-
+	    /// <summary>
+        /// Serialize the item to a string
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="item"></param>
+        /// <returns></returns>
         public string Serialize<T>(T item)
         {
             var sb = new StringBuilder();
@@ -87,24 +94,4 @@ private void SerializeNode<T>(T item, StringBuilder sb, int indentation)
             }
         }
     }
-
-    internal static class SerializerExtensions
-    {
-	    private static char[] SpecialChars = new[] { ':', '[', ']' };
-
-		public static string ToSerializeableString(this object value)
-	    {
-		    if (value == null)
-		    {
-				return null;
-		    }
-
-		    if (value is string s && SpecialChars.Any(c => s.Contains(c)))
-		    {
-			    value = $"'{s}'";
-		    }
-
-		    return value.ToString();
-	    }
-    }
 }

src/YamlMap/Serialization/TypeConverter.cs

@@ -3,8 +3,18 @@
 
 namespace YamlMap.Serialization
 {
-    public class TypeConverter
+    /// <summary>
+    /// Converter that converts a string value to a defined type
+    /// </summary>
+    public static class TypeConverter
     {
+        /// <summary>
+        /// Convert the string to a given type
+        /// </summary>
+        /// <param name="type"></param>
+        /// <param name="value"></param>
+        /// <returns></returns>
+        /// <exception cref="FormatException"></exception>
         public static object Convert(Type type, string value)
         {
             if (type == typeof(string))
@@ -115,6 +125,11 @@ public static object Convert(Type type, string value)
             return null;
         }
 
+        /// <summary>
+        /// Parser a string to a boolean
+        /// </summary>
+        /// <param name="value"></param>
+        /// <returns></returns>
         public static bool ParseBoolean(object value)
         {
             if (value == null || value == DBNull.Value)