See symfony/symfony#21763

Because there have been so many iterations on the DI component for 3.3, I'm not sure what's documented / has docs issues and what doesn't. So, apologies of this is a duplicate - but I wanted to help make sure that all the different parts of this are not forgotten.