diff --git a/README.md b/README.md
index 6bffcaf..77b9bd9 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,14 @@ A JSON schema code generator for Go.
 
     jsonschemagen -s <schema> -o <output>
 
+One Go type per definition will be generated.
+
+- `int64` is used for `"type": "integer"`.
+- `json.Number` is used for `"type": "number"`.
+- Go structs are generated for objects with `"additionalProperties": false`.
+- `json.RawMessage` is used when a value can have multiple types. Helpers are
+  generated for `allOf`, `anyOf`, `oneOf` which are references.
+
 ## License
 
 MIT