Use the ".. deprecated::" directive for deprecations#11178

OskarStark wants to merge 2 commits intosymfony:3.4symfony/symfony-docs:3.4from

OskarStark:use-new-deprecated-directiveOskarStark/symfony-docs:use-new-deprecated-directiveCopy head branch name to clipboard