diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2adbf88
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+# SyntheticJsonSerializer
+a JSON serializer based on bytecode manipulation
+
+* creates a Json serializer for a java type using javassist
+* deserializing not implemented
+* see the unit tests to see how it works