Let's wait a bit before documenting this because someone (🙄) has asked to rethink the proposed implementation: https://github.com/symfony/symfony/pull/24778#issuecomment-369879079 https://github.com/symfony/symfony/pull/24778