Added docs for the changes proposed in symfony/symfony#8908