[WIP] Added documentation for GroupSequence

[ClementGautier]

Q	A
Doc fix?	yes
New docs?	yes
Applies to	all
Fixed tickets	#1248

The GroupSequence feature has never been documented.

@bschussek Can you review this ? You made an explanation on this topic about this feature: http://stackoverflow.com/questions/9996618/symfony2-dependency-between-validation-asserts

[stof]

This is wrong. It does not correspond to the example

[ClementGautier]

Why ? The entity class in the example is User so the validation group is named User right ?

[stof]

you should also document the other way to use group sequences: instead of having a static sequence in the annotation, you can have a dynamic sequence by implementing Symfony\Component\Validator\GroupSequenceProviderInterface in your model and mapping your class with @Assert\GroupSequenceProvider

[wouterj]

Thanks for starting on this one! Could you please include the pull request format? This fixes issue #1248

[ClementGautier]

Thanks @stof and @wouterj I will update the PR in few hours

[ClementGautier]

@stof I will not document GroupSequenceProvider in this PR as I don't know how it work and when it was added (I think it is a 2.1 feature right ?). Can you make a PR for it when you have time ?

[stof]

@ClementGautier No, it is also a 2.0 feature. The only difference is that the array of group is returned by a method (and so can be build based on some logic) instead of being hardcoded.

[ClementGautier]

@stof I will find a smart use case of GroupSequenceProvider latter and make an other PR.

[ClementGautier]

Sounds good to me now.

@stof / @bschussek / @wouterj : Is it ok for you ?

[lyrixx]

You miss the GroupSequence here ;)

[ClementGautier]

fixed. Thx

[wouterj]

👍

(if you know how to do it, could you please squash the commits?)

[ClementGautier]

squashed 👍

[weaverryan]

Hi Clement!

Very nice addition! I've merged this in with only minor changes. I've also opened issue #2664 as a placeholder for @stof's suggestion.

Thanks everyone!