Merge pull request #267 from dunglas/10doc

Extract the doc

Author: dunglas

Resources/meta/LICENSE renamed to LICENSE

@@ -1,8 +1,8 @@
 # DunglasApiBundle
 
-DunglasApiBundle is an easy to use and powerful system to create [hypermedia-driven REST APIs](http://en.wikipedia.org/wiki/HATEOAS).
-It is a component of the [Dunglas's API Platform framework](http://api-platform.com) and it can be used
-as a standalone bundle for [the Symfony framework](http://symfony.com).
+DunglasApiBundle is an easy to use and powerful system to create [hypermedia-driven REST APIs](https://en.wikipedia.org/wiki/HATEOAS).
+It is a component of the [API Platform framework](https://api-platform.com) and it can be used
+as a standalone bundle for [the Symfony framework](https://symfony.com).
 
 It embraces [JSON for Linked Data (JSON-LD)](http://json-ld.org) and [Hydra Core Vocabulary](http://www.hydra-cg.com) web standards. 
 
@@ -15,99 +15,10 @@ high performance API-first projects.
 [![Dependency Status](https://www.versioneye.com/user/projects/5552e93306c318a32a0000fa/badge.svg?style=flat)](https://www.versioneye.com/user/projects/5552e93306c318a32a0000fa)
 [![HHVM Status](http://hhvm.h4cc.de/badge/dunglas/api-bundle.svg)](http://hhvm.h4cc.de/package/dunglas/api-bundle)
 
-## Features
+## Documentation
 
-Here is the fully-featured REST API you'll get in minutes, I promise:
+The documentation of this bundle is available online and can be edited in
+[its dedicated repository](https://github.com/api-platform/doc).
 
-* CRUD support through the API for Doctrine entities: list, `GET`, `POST`, `PUT` and `DELETE`
-* Hypermedia implementing [JSON-LD](http://json-ld.org)
-* Machine-readable documentation of the API in the [Hydra](http://hydra-cg.com) format, guessed from PHPDoc, Serializer,
-Validator and Doctrine ORM metadata
-* Human-readable Swagger-like documentation including a sandbox automatically generated thanks to the integration with
-[NelmioApiDoc](https://github.com/nelmio/NelmioApiDocBundle)
-* Pagination (compliant with Hydra)
-* List filters (compliant with Hydra)
-* Validation using the Symfony Validator Component, with groups support
-* Errors serialization (compliant with Hydra)
-* Custom serialization using the Symfony Serializer Component, with groups support and the possibility to embed relations
-* Automatic routes registration
-* Automatic entrypoint generation giving access to all resources
-* `\DateTime` serialization and deserialization
-* [FOSUserBundle](https://github.com/FriendsOfSymfony/FOSUserBundle) integration (user management)
-* Easy installation thanks to API Platform
-
-Everything is fully customizable through a powerful event system and strong OOP.
-This bundle is documented and tested with Behat (take a look at [the `features/` directory](features/)).
-
-![Screenshot of DunglasApiBundle integrated with NelmioApiDocBundle](Resources/doc/images/NelmioApiDocBundle.png)
-
-## Official documentation
-
-1. [Getting Started](Resources/doc/getting-started.md)
-  1. [Installing DunglasApiBundle](Resources/doc/getting-started.md#installing-dunglasapibundle)
-  2. [Configuring the API](Resources/doc/getting-started.md#configuring-the-api)
-  3. [Mapping the entities](Resources/doc/getting-started.md#mapping-the-entities)
-  4. [Registering the services](Resources/doc/getting-started.md#registering-the-services)
-2. [NelmioApiDocBundle integration](Resources/doc/nelmio-api-doc.md)
-3. [Operations](Resources/doc/operations.md)
-  1. [Disabling operations](Resources/doc/operations.md#disabling-operations)
-  2. [Creating custom operations](Resources/doc/operations.md#creating-custom-operations)
-4. [Data providers](Resources/doc/data-providers.md)
-  1. [Creating a custom data provider](Resources/doc/data-providers.md#creating-a-custom-data-provider)
-  2. [Returning a paged collection](Resources/doc/data-providers.md#returning-a-paged-collection)
-  3. [Supporting filters](Resources/doc/data-providers.md#supporting-filters)
-  4. [Extending the Doctrine Data Provider](Resources/doc/data-providers.md#extending-the-doctrine-data-provider)
-5. [Filters](Resources/doc/filters.md)
-  1. [Search filter](Resources/doc/filters.md#search-filter)
-  2. [Date filter](Resources/doc/filters.md#date-filter)
-    1. [Managing `null` values](Resources/doc/filters.md#managing-null-values)
-  3. [Order filter](Resources/doc/filters.md#order-filter)
-    1. [Using a custom order query parameter name](Resources/doc/filters.md#using-a-custom-order-query-parameter-name)
-  4. [Enabling a filter for all properties of a resource](Resources/doc/filters.md#enabling-a-filter-for-all-properties-of-a-resource)
-  5. [Creating custom filters](Resources/doc/filters.md#creating-custom-filters)
-    1. [Creating custom Doctrine ORM filters](Resources/doc/filters.md#creating-custom-doctrine-orm-filters)
-    2. [Overriding extraction of properties from the request](Resources/doc/filters.md#overriding-extraction-of-properties-from-the-request)
-6. [Serialization groups and relations](Resources/doc/serialization-groups-and-relations.md)
-  1. [Using serialization groups](Resources/doc/serialization-groups-and-relations.md#using-serialization-groups)
-  2. [Annotations](Resources/doc/serialization-groups-and-relations.md#annotations)
-  3. [Embedding relations](Resources/doc/serialization-groups-and-relations.md#embedding-relations)
-    1. [Normalization](Resources/doc/serialization-groups-and-relations.md#normalization)
-    2. [Denormalization](Resources/doc/serialization-groups-and-relations.md#denormalization)
-  4. [Name conversion](Resources/doc/serialization-groups-and-relations.md#name-conversion)
-  5. [Entity identifier case](Resources/doc/serialization-groups-and-relations.md#entity-identifier-case)
-7. [Validation](Resources/doc/validation.md)
-  1. [Using validation groups](Resources/doc/validation.md#using-validation-groups)
-8. [The event system](Resources/doc/the-event-system.md)
-  1. [Retrieving list](Resources/doc/the-event-system.md#retrieving-list)
-  2. [Retrieving item](Resources/doc/the-event-system.md#retrieving-item)
-  3. [Creating item](Resources/doc/the-event-system.md#creating-item)
-  4. [Updating item](Resources/doc/the-event-system.md#updating-item)
-  5. [Deleting item](Resources/doc/the-event-system.md#deleting-item)
-  6. [JSON-LD context builder](Resources/doc/the-event-system.md#json-ld-context-builder)
-  7. [Registering an event listener](Resources/doc/the-event-system.md#registering-an-event-listener)
-9. [Resources](Resources/doc/resources.md)
-  1. [Using a custom `Resource` class](Resources/doc/resources.md#using-a-custom-resource-class)
-10. [Controllers](Resources/doc/controllers.md)
-  1. [Using a custom controller](Resources/doc/controllers.md#using-a-custom-controller)
-11. [FOSUserBundle integration](Resources/doc/fosuser-bundle.md#fosuser-bundle-integration)
-  1. [Creating a `User` entity with serialization groups](Resources/doc/fosuser-bundle.md#creating-a-user-entity-with-serialization-groups)
-12. [Using external (JSON-LD) vocabularies](Resources/doc/external-vocabularies.md)
-13. [Performances](Resources/doc/performances.md)
-  1. [Enabling the metadata cache](Resources/doc/performances.md#enabling-the-metadata-cache)
-14. [AngularJS integration](Resources/doc/angular-integration.md)
-
-## Other resources
-
-### Filters
-
-* [LoopBackApiBundle](https://github.com/theofidry/LoopBackApiBundle): provides a set of Doctrine ORM filters for more advanced query operations
-
-### Slides
-
-* (french) [A la découverte de API Platform (Symfony Live Paris 2015)](http://dunglas.fr/2015/04/mes-slides-du-symfony-live-2015-a-la-decouverte-de-api-platform/)
-* (french) [API-first et Linked Data avec Symfony (sfPot Lille 2015)](http://les-tilleuls.coop/slides/dunglas/slides-sfPot-2015-01-15/#/)
-
-## Credits
-
-DunglasApiBundle is part of the API Platform project. It is developed by [Kévin Dunglas](http://dunglas.fr),
-[Les-Tilleuls.coop](http://les-tilleuls.coop) and [awesome contributors](https://github.com/dunglas/DunglasApiBundle/graphs/contributors).
+* [Get started with API Platform](https://api-platform.com/doc/1.0/getting-started/)
+* [A documentation](https://api-platform.com/doc/1.0/api-bundle/)