Add doc to custom normalizer

[yecraftsman]

Reference: api-platform/core#316

[dupuchba]

shouldn't it be NormalizerInterface?

[yecraftsman]

Well seen, since normalize and denormalize can check both.

[teohhanhui]

"must implements" -> "must implement"

Also, there's an AbstractNormalizer which makes things easier...

[teohhanhui]

It's unclear as to what you're trying to achieve here... (Yes, I've read api-platform/core#316 but I still don't understand what this doc section is demonstrating.)

[dunglas]

@yelmontaser any update on this PR?

[yecraftsman]

@teohhanhui as shown in the following post api-platform/core#316, the Dunglas API does not permit to specify a serialization group in some contexts, such as having diffirents following groups that is in the resource or in the collection or simply when a user is authenticated etc.

The problem of the method initNormalizationContext is that it applies the group in general context of the resource and collection.
The objective is not to create a new serializer but to simply add a class that helps control the context of application groups.

Have you another good easy way to do it?

[yecraftsman]

I understand that it is a bit ambiguous, but I think that the proposal @dunglas is cleaner than doing it through a controller or event.

[sroze]

@yelmontaser so we should close this PR?

[yecraftsman]

@sroze close if not necessary

[dunglas]

I'm 👍 to merge this PR when comments of @teohhanhui will be fixed. It would be nice to also add a link to the related Symfony doc.

[Simperfit]

@yelmonster, Do you have some time to finish this PR ?

[yecraftsman]

@Simperfit sorry I do not have time right now and the API-Platform has changed significantly since.