[Constraints] Fixed incosistenties and reordered config blocks

[wouterj]

Q	A
Doc fix?	yes
New docs?	no
Applies to	all
Fixed tickets	-

I planned to do a config block reorder PR, but before that, I just want to know what you think about this. This PR reordered the configuration blocks in the constraints reference and fixes some other issues with the examples.

If you think it is good to recheck the order of all configuration blocks in the docs, we should think of the best order. In general, it will be yaml, [annotations,] xml, php, but in the big bundles, you see that xml is used a lot for service configuration, we should maybe have a xml, yaml, php order there.

PS: I don't start with the next PR about this topic soon, let's document important features first! 📘

[stof]

I would still keep Yaml as first block for services. Many people are using YAML in their projects AFAIK as it is less verbose. However, we should take care to have the XML version on all examples.
For application configs, I think most people are using YAML (which is far more readable than the verbose XML) so it should also stay first.

Big bundles are using XML because it is the best practice advocated for shared bundles (the XSD validation forbids a bunch of mistakes as they are spotted early instead of during a WTF).

[ludofleury]

Here's a poll about configuration format usage: https://docs.google.com/forms/d/15pMCom5qzk5IpKPqfGqmRvLhiGIt0_zKMA4FZtrJyos/viewform

I will publish the result at the end of the week.

[lyrixx]

Btw, on a mainling/issue (don't remember, sorry) people said symfony.com could set a cookie to keep the "prefered" config type.

[wouterj]

@lyrixx we already had some discussion about that in #1883

[lyrixx]

@wouterj Yes, thanks ;) I remember now

[weaverryan]

Hi guys!

It depends on which area we're talking about (so @ludofleury's poll asks it well), but here's where we stand now:

• ORM: annotations, yaml, xml
• Validation: yaml, annotations, xml, php
• Services: yaml, xml, php
• Routing: yaml, xml, php (annotations not shown)

I feel very good about this - we decided a long time ago to show YAML, and it seems to be what most people use. The only questionable one for me is validation - I can't remember why we put yaml before annotations, personally I do validation in annotations.

[weaverryan]

Oh, and I forgot to say thanks to @wouterj for this PR 👍 for consistency!