Controller - Forwarding chapter contains deprecated code

[hacfi]

The Controller - Forwarding chapter gives a code example which is deprecated since 2.3:

$httpKernel = $this->container->get('http_kernel');
$response = $httpKernel->forward(
    'AcmeHelloBundle:Hello:fancy',
    array(
        'name'  => $name,
        'color' => 'green',
    )
);

Symfony no longer uses the extended FrameworkBundle HttpKernel class which added the forward method. See:
HttpKernel deprecated notice
Changelog - 2. bulletpoint

I don’t know if you want to update the code example or just remove it.

[wouterj]

It's deprecated since 2.2 and removed in 2.3.

Related issue: symfony/symfony#8783

I vote to remove the current tip and add a new sidebar-like thing explaining something about sub requests (including the example shown in the issue above). I actually don't know if we have documentation about sub requests, but if we have we should add a link to it too.

[xabbuh]

We have a small section on sub-requests in the HttpKernel Component's documentation. I think we can adapt the example explained there and link to this section.