diff --git a/nlohmann::basicjson.md b/nlohmann::basicjson.md
index 432c9b0..85f5789 100644
--- a/nlohmann::basicjson.md
+++ b/nlohmann::basicjson.md
@@ -14,15 +14,26 @@ template <
 
 ## Template parameters
 
-- `ObjectType`
-- `ArrayType`
-- `StringType`
-- `BooleanType`
-- `NumberIntegerType`
-- `NumberFloatType`
-- `AllocatorType`
+- `ObjectType` - container type used for JSON objects 
+- `ArrayType` - container type used for JSON arrays 
+- `StringType` - container type used for JSON strings
+- `BooleanType` - type used for JSON boolean 
+- `NumberIntegerType` - type used for JSON numbers (integers) 
+- `NumberFloatType` - type used for JSON numbers (floating point) 
+- `AllocatorType` - [Allocator](http://en.cppreference.com/w/cpp/concept/Allocator) type used to allocate internal storage
 
-## Iterator invalidation
+## Typedefs
+
+| Type | Definition |
+| --- | --- |
+| `object_t` | `ObjectType<StringType, basic_json>` |
+| `array_t` | `ArrayType<basic_json>` |
+| `string_t` | `StringType` |
+| `boolean_t` | `BooleanType` |
+| `number_integer_t` | `NumberIntegerType` |
+| `number_float_t` | `NumberFloatType` |
+| `list_init_t` | `std::initializer_list<basic_json>` |
+| `json` | basic_json<> |
 
 ## Member types