Update README.md

Author: giometrix

README.md

@@ -8,9 +8,84 @@ The Azure Storage SDK requires that objects that it works with to implement the
 
 This simple library seeks to take care of the mapping for us, so that you can continue to write your domain objects as POCOs, while still being able to leverage the Azure Storage SDK.
 
+The library will convert simple properties to fields in Azure Table Storage.  Complex types will serialize as json.
+
 Examples
 ========
 We'll use the following two classes for our examples
 
+```csharp
+    public class Department
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Guid? OptionalId { get; set; }
+      
+    }
+    public class Employee
+    {
+        public Employee()
+        {
+            
+        }
+        public string Company { get; set; }
+        public int Id { get; set; }
+        public Guid ExternalId { get; set; }
+        public string Name { get; set; }
+        public DateTimeOffset HireDate { get; set; }
+        public DateTimeOffset? TermDate { get; set; }
+        public Department Department { get; set; }
+    }
+```
+
+## Convert to Table Entity
+Converting to a table entity is easy.  Use the ``.ToTableEntity()`` extension method and specify which properties represent the partition key and row key.  If you need to customize how any of those two keys serialize there are overloads that accept string values.
+
+Example:
+```csharp
+var emp = new Employee()
+            {
+                Company = "Microsoft",
+                Name = "John Smith",
+                Department = new Department
+                {
+                    Name = "QA",
+                    Id = 1,
+                    OptionalId = null
+                },
+                Id = 42,
+                ExternalId = Guid.Parse("e3bf64f4-0537-495c-b3bf-148259d7ed36"),
+                HireDate = DateTimeOffset.Parse("Thursday, January 31, 2008")
+            };
+            var tableEntity = emp.ToTableEntity(e => e.Company, e => e.Id);
+```
+
+Below is an example that uses string keys instead:
+```csharp
+ var emp = new Employee()
+            {
+                Name = "John Smith",
+                Department = new Department
+                {
+                    Name = "QA",
+                    Id = 1,
+                    OptionalId = null
+                },
+                ExternalId = Guid.Parse("e3bf64f4-0537-495c-b3bf-148259d7ed36"),
+                HireDate = DateTimeOffset.Parse("Thursday, January 31, 2008")
+            };
+            var tableEntity = emp.ToTableEntity("Google", "42");
+```
+## Convert from Table Entity
+Converting from a table entity is just as simple.  If the both the partition keys can be converted to simple types, you can use the shorter overloaded extension method (```FromTableEntity```).
 
+Here is a simple example where we specify the partition key (```Company```) and the row key (```Id```):
+```csharp
+ var employee = tableEntity.FromTableEntity<Employee, string, int>(e => e.Company, e => e.Id);
+```
 
+Here is an example where a more complicated key was used, which is common in azure table storage because of the lack of indexes.
+```csharp
+var employee = tableEntity.FromTableEntity<Employee, string, int>(e=>e.Company, pk=>pk.Substring("company_".Length), e => e.Id, rk=>int.Parse(rk.Substring("employee_".Length)));
+```
+In this example the partitionkey had a prefix of "company_" and the row key had a prefix of "employee_".