diff --git a/README.md b/README.md
index 1505e0b..8e6db63 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,13 @@
-# scim-schema
+# Scim Schema
 
-SCIM schema PHP library
+SCIM schema PHP library with support for both v1 and v2.
+
+> **Note:** This library is still work in progress, and you are welcome to help and contribute
+
+> It was made by the specs from [SimpleCloud](http://www.simplecloud.info/) and by the example documents generated by
+[PowerDMS/Owin.Scim](https://github.com/PowerDMS/Owin.Scim)
+
+> Also, do not miss SCIM Filter Parser (https://github.com/tmilos/scim-filter-parser) !
 
 [![Author](http://img.shields.io/badge/author-@tmilos-blue.svg?style=flat-square)](https://twitter.com/tmilos77)
 [![Build Status](https://travis-ci.org/tmilos/scim-schema.svg?branch=master)](https://travis-ci.org/tmilos/scim-schema)
@@ -8,3 +15,68 @@ SCIM schema PHP library
 [![Quality Score](https://img.shields.io/scrutinizer/g/tmilos/scim-schema.svg?style=flat-square)](https://scrutinizer-ci.com/g/tmilos/scim-schema)
 [![License](https://img.shields.io/packagist/l/tmilos/scim-schema.svg)](https://packagist.org/packages/tmilos/scim-schema)
 [![Packagist Version](https://img.shields.io/packagist/v/tmilos/scim-schema.svg?style=flat-square)](https://packagist.org/packages/tmilos/scim-schema)
+
+
+# Schema
+
+Build default schema
+
+```php
+<?php
+$schemaBuilder = new SchemaBuilderV2(); // or SchemaBuilderV1
+
+$groupSchema = $schemaBuilder->getGroup();
+$userSchema  = $schemaBuilder->getUser();
+$enterpriseUserSchema = $schemaBuilder->getEnterpriseUser();
+$schemaSchema = $schemaBuilder->getSchema();
+$serviceProviderConfigSchema = $schemaBuilder->getServiceProviderConfig();
+$resourceTypeSchema = $schemaBuilder->getResourceType();
+```
+
+Or build your own custom schema
+
+```php
+<?php
+$schema = new Schema();
+$schema->setName('CustomSchema);
+$schema->addAttribute(
+    AttributeBuilder::create('name', ScimConstants::ATTRIBUTE_TYPE_STRING, 'Name of the object')
+        ->setMutability(false)
+        ->getAttribute()
+);
+```
+
+And serialize the scim schema object
+
+```php
+<?php
+$schema = (new SchemaBuilderV2())->getUser();
+$schema->serializeObject();
+```
+
+
+
+# Schema validation
+
+An object can be validated against a schema
+
+```php
+/** @var object|array $object */
+$object = getTheObject();
+
+$validator = new SchemaValidator();
+$objectSchema = getTheSchema();
+$schemaExtensions = getSchemaExtensions();
+
+$validationResult = $validator->validate(
+    $object,
+    $objectSchema,
+    $schemaExtensions
+);
+
+if (!$validationResult->getErrors()) {
+    // cool!
+} else {
+    print implode("\n", $validationResult->getErrorsAsStrings());
+}
+```