Exclusion groups documentation is confusing

[beyerz]

I use this bundle together with jms serializer and fos rest to provide a simple and easy interface.

I came across a situation where I wanted to serialize my entities differently by groups. After implementing this using jms annotations, I no longer had my _links as part of the serialized response.

I read about group in exclusion for Relation annotation, but since this is in exclusion, I made the assumption that this means the relation would be excluded for the specified groups.

In the end I put the group in the exclusion and now my _links show.

Having the group in exclusion and not as a separate attribute on the Relation is counterintuitive.

I would suggest that is either clarified better in the documentation or developed into a more intuitive attribute.