New Hydra API generator: feedback needed

Hi,

I've published a new tool to create hypermedia REST API with the Symfony
framework.
It supports JSON-LD and Hydra and leverages Symfony to make it really easy
to the average web developper to create that kind of API. Even if they
don't share any code, this bundle has been inspirited by Markus's
HydraBundle and can be considered as a HydraBundle on steroid.

It uses Doctrine, Symfony Serializer (2.7) and Symfony Validator metadata
to generate the Hydra documentation (no need for special annotations -
except for external IRIs -, a typical Doctrine entity class will works
great without any extra work) ; it supports out of the box serialization
and deserialization groups, pagination, filters, errors and is highly
extensible (event system, pluggabbles normalizers).
The code source and the full list of features is available on GitHub:
https://github.com/dunglas/DunglasJsonLdApiBundle

I've also built a demo API (a bookstore). The source code is also available
on GitHub: https://github.com/dunglas/api-platform
A public endpoint is available here: http://bookstore-api.dunglas.fr
HydraConsole:
http://www.markus-lanthaler.com/hydra/console/?url=http://bookstore-api.dunglas.fr

It works great with the Hydra console. However, there is two features not
well described in the generated Hydra documentation and I don't know how to
handle that correctly:

   - Filters (ex: http://bookstore-api.dunglas.fr/organizations?name=another)
   are not described in the Hydra documentation. I've read about hydra:search
   in the spec but I don't know where is the preferred way to add those
   definitions. In hydra:supportedOperation? Do you have an example of an API
   using hydra:search available?
   - Many-To-Many relations such as the author property in this document:
   http://bookstore-api.dunglas.fr/books/2 An hydra documentation is
   generated but should be invalid because the collection of is not recognized
   by Hydra console. Any hint on how to fix that?

Any feedback, both on the JSON-LD / Hydra support and on the ease of use as
a web developer is welcome.

P.S.: I've read on the list about a new Collection format but wasn't able
to find the mail or the issue where it is described, can you send me a
pointer to this new format?

Best regards,


-- 
Kévin Dunglas

http://dunglas.fr