add more docs

Author: Bulat Shakirzyanov

README.md

@@ -14,13 +14,10 @@ This is a wrapper around [the DataStax C/C++ Driver for Apache Cassandra and Dat
 * IRC: #datastax-drivers on [irc.freenode.net](http://freenode.net>)
 * Twitter: Follow the latest news about DataStax Drivers - [@avalanche123](http://twitter.com/avalanche123), [@al3xandru](https://twitter.com/al3xandru)
 
-## Status of v1.0.0
-
-This is the first stable release of the DataStax PHP Driver.
-
 ## What's new in v1.0.0:
 
 * [Schema Metadata API](http://datastax.github.io/php-driver/features/#schema-metadata).
+* [Type Metadata API](http://datastax.github.io/php-driver/features/#data-types).
 
 ## Feedback Requested
 

features/README.md

@@ -483,6 +483,25 @@ foreach ($schema->keyspaces() as $keyspace) {
 
 **NOTE** A new instance of [`Cassandra\Schema`](http://datastax.github.io/php-driver/api/Cassandra/interface.Schema/) is returned each time [`Cassandra\Session::schema()`](http://datastax.github.io/php-driver/api/Cassandra/interface.Session/#method.schema) is called. This instance is a simple value object and its information, such as keyspaces, tables and columns will not be kept up-to-date with the state of the cluster. In order to obtain the latest schema metadata, you have to call [`Cassandra\Session::schema()`](http://datastax.github.io/php-driver/api/Cassandra/interface.Session/#method.schema) again.
 
+### Data Types
+
+The PHP driver for Apache Cassandra supports [a variety of datatypes](http://datastax.github.io/php-driver/features/datatypes/).
+
+You can also use the rich type metadata API to define and inspect types, as well as validate data objects.
+
+The example below defines and creates a [`Cassandra\Map`](http://datastax.github.io/php-driver/api/Cassandra/class.Map/) using [`Cassandra\Type`](http://datastax.github.io/php-driver/api/Cassandra/interface.Type/) interface.
+
+```php
+<?php
+
+$map = Cassandra\Type::map(Cassandra\Type::varchar(), Cassandra\Type::int())
+                     ->create('a', 1, 'b', 2, 'c', 3, 'd', 4);
+
+var_dump(array_combine($map->keys(), $map->values()));
+```
+
+**NOTE** The `create()` method or various types validates and coerces provided values into the target type.
+
 ### Logging
 
 You can configure the location of the log file for the driver as well as the log level using the following `php.ini` settings: