Documentation about Yaml, mention it as discouraged to use?

[linaori]

Q	A
BC Break	no
Version	2.6

Summary

The documentation page about Yaml does not mention anything about it being removed/unsupported in the future. I think it's a good idea to mention on here that it's discouraged to use Yaml as configuration.

Whenever I see people suggest to not use Yaml because it's going to be removed as core supported configuration, the response is usually "oh I did not know that".

[Ocramius]

@doctrine/team-documentation can we do something about this one?

[SenseException]

This should get a highlighted box at the beginning of the page mentioning its deprecation and removal.

I guess this part of the ORM documentation can be removed for the right ORM version.

[weaverryan]

I would be +1 for removing it on the latest minor version docs. Basically, because it is now deprecated, why show it at all? Older versions of the docs will still exist for existing users to reference. We can cleanup the new version right now.

[linaori]

It's already known to be deprecated and 2.6 is the current documentation. If a developer takes a look at the documentation, and doesn't see a deprecation, chances are that everything is going to be created in Yaml. This is a waste of time for the developer because it's already known to disappear with 3.0. Not letting the developer know this as soon as possible, will thus result in extra work while it was not necessary.

[SenseException]

@iltar I've created PR #7374. Does it cover this issue?

[linaori]

Looks good to me!

[Majkl578]

#7374 has been merged into 2.6.
https://www.doctrine-project.org/projects/doctrine-orm/en/2.6/reference/yaml-mapping.html#yaml-mapping