diff --git a/lib/pure/json.nim b/lib/pure/json.nim
index b9da8a0dd0..5a819b7d8c 100644
--- a/lib/pure/json.nim
+++ b/lib/pure/json.nim
@@ -49,6 +49,10 @@
 ##         "age": herAge
 ##       }
 ##     ]
+##
+##    var j2 = %* {"name": "Isaac", "books": ["Robot Dreams"]}
+##    j2["details"] = %* {"age":35, "pi":3.1415}
+##    echo j2
 
 import
   hashes, tables, strutils, lexbase, streams, unicode, macros