Update readme.

Author: treeform

README.md

@@ -8,6 +8,15 @@ With this library you can parse json your way, from the mess you get to the obje
 
 Current standard module first parses json into JsonNodes and then turns the JsonNodes into objects you want. This is slower and creates unnecessary work for the garbage collector. This library skips the JsonNodes and creates the objects you want directly.
 
+## Can parse most object types:
+
+* numbers and strings
+* objects and ref objects
+* enums
+* tuples
+* seq and arrays
+* tables
+
 ## Not strict.
 
 Extra json fields are ignored and missing json fields keep their default values. Json is never exactly what you want.
@@ -20,9 +29,26 @@ var v = fromJson[Entry1](s)
 doAssert v.color == ""
 ```
 
+## Snake_case or CamelCase
+
+Nim usually uses camalCase for its variables, while a bunch of json in the wild uses snake_case. This library will convert snake_case to camalCase for you when reading json.
+
+```nim
+type Entry4 = object
+colorBlend: string
+
+var v = fromJson[Entry4]("""{"colorBlend":"red"}""")
+doAssert v.colorBlend == "red"
+
+v = fromJson[Entry4]("""{"color_blend":"red"}""")
+doAssert v.colorBlend == "red"
+```
+
 ## Has hooks.
 
-### `proc newHook(foo: var ...)` Can be used to populate default values.
+### `proc newHook()` Can be used to populate default values.
+
+Some times absence of a field means it should have a default value. Normally hits would just be Nim's default value for the variable type. But with the newHook() you can setup the object with defaults before the main parsing happens.
 
 ```nim
 type
@@ -39,15 +65,17 @@ doAssert v.id == "123"
 doAssert v.visible == "yes"
 ```
 
-### `proc enumHook[...](v: string): ...` Can be used to parse enums.
+### `proc enumHook()` Can be used to parse enums.
+
+In wild json enums name almost never match to nim enum names that usually have a prefix. The enumHook() allows you to rename the enums to your internal names.
 
 ```nim
 type Color2 = enum
   c2Red
   c2Blue
   c2Green
 
-proc enumHook[Color2](v: string): Color2 =
+proc enumHook(v: string): Color2 =
   case v:
   of "RED": c2Red
   of "BLUE": c2Blue
@@ -57,4 +85,20 @@ proc enumHook[Color2](v: string): Color2 =
 doAssert fromJson[Color2](""" "RED" """) == c2Red
 doAssert fromJson[Color2](""" "BLUE" """) == c2Blue
 doAssert fromJson[Color2](""" "GREEN" """) == c2Green
-```
+```
+
+### `proc renameHook()` Can be used to rename fields at run time.
+
+In wild json field names can be reserved words such as type, class, or array. With the renameHook you can rename fields to what you want on the type you need.
+
+```nim
+type Node = ref object
+  kind: string
+
+proc renameHook(v: var Node, fieldName: var string) =
+  if fieldName == "type":
+    fieldName = "kind"
+
+var node = fromJson[Node]("""{"type":"root"}""")
+doAssert node.kind == "root"
+```