Include short description, license in README
hslua-aeson
===========
-Simple interfacing with Lua for Aeson enabled data.
+Glue to hslua for aeson values.
+This provides a `StackValue` instance for aeson's `Value` type. The following
+conventions are used:
+
+- `Null` values are encoded as the special global `_NULL`. Using `Nil` would
+ cause problems with null-containing arrays.
+
+- Objects are converted to tables in a straight-forward way.
+
+- Arrays are converted to lua tables. Array-length is included as the value at
+ index 0. This makes it possible to distinguish between empty arrays and empty
+ objects.
+
+
+License
+-------
+
+This project is licensed under the liberal MIT license, the same license under
+which hslua and lua itself are published. See the [LICENSE](./LICENSE) file for
+details.
