update documentation for creating custom resource controller

docs/customization/controller.rst

@@ -60,7 +60,6 @@ getting a list of recommended products from your external api.
 
     namespace App\Controller;
 
-    use FOS\RestBundle\View\View;
     use Sylius\Bundle\ResourceBundle\Controller\ResourceController;
     use Sylius\Component\Resource\ResourceActions;
     use Symfony\Component\HttpFoundation\Request;
@@ -75,29 +74,24 @@ getting a list of recommended products from your external api.
             $this->isGrantedOr403($configuration, ResourceActions::SHOW);
             $product = $this->findOr404($configuration);
 
+            // some custom provider service to retrieve recommended products
             $recommendationService = $this->get('app.provider.product');
 
             $recommendedProducts = $recommendationService->getRecommendedProducts($product);
 
             $this->eventDispatcher->dispatch(ResourceActions::SHOW, $configuration, $product);
 
-            $view = View::create($product);
-
             if ($configuration->isHtmlRequest()) {
-                $view
-                    ->setTemplate($configuration->getTemplate(ResourceActions::SHOW . '.html'))
-                    ->setTemplateVar($this->metadata->getName())
-                    ->setData([
-                        'configuration' => $configuration,
-                        'metadata' => $this->metadata,
-                        'resource' => $product,
-                        'recommendedProducts' => $recommendedProducts,
-                        $this->metadata->getName() => $product,
-                    ])
-                ;
+                return $this->render($configuration->getTemplate(ResourceActions::SHOW . '.html'), [
+                    'configuration' => $configuration,
+                    'metadata' => $this->metadata,
+                    'resource' => $product,
+                    'recommendedProducts' => $recommendedProducts,
+                    $this->metadata->getName() => $product,
+                ]);
             }
 
-            return $this->viewHandler->handle($configuration, $view);
+            return $this->createRestView($configuration, $product);
         }
     }
 
@@ -111,18 +105,7 @@ getting a list of recommended products from your external api.
                 classes:
                     controller: App\Controller\ProductController
 
-**3.** The next thing you have to do is to override the ``sylius.repository.product`` service definition in the ``config/services.yaml``.
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        app.provider.product:
-            class: App\Provider\ProductProvider
-            arguments: ['@sylius.repository.product']
-            public: true
-
-**4.** Disable autowire for your controller in ``config/services.yaml``
+**3.** Disable autowire for your controller in ``config/services.yaml``
 
 .. code-block:: yaml
 
@@ -160,27 +143,27 @@ If you still need the methods of the original ``HomepageController``, then copy
 
     namespace App\Controller\Shop;
 
-    use Symfony\Bundle\FrameworkBundle\Templating\EngineInterface;
     use Symfony\Component\HttpFoundation\Response;
+    use Twig\Environment;
 
     final class HomepageController
     {
-        /** @var EngineInterface */
-        private $templatingEngine;
+        /** @var Environment */
+        private $twig;
 
-        public function __construct(EngineInterface $templatingEngine)
+        public function __construct(Environment $twig)
         {
-            $this->templatingEngine = $templatingEngine;
+            $this->twig = $twig;
         }
 
         public function indexAction(): Response
         {
-            return $this->templatingEngine->renderResponse('@SyliusShop/Homepage/index.html.twig');
+            return new Response($this->twig->render('@SyliusShop/Homepage/index.html.twig'));
         }
 
         public function customAction(): Response
         {
-            return $this->templatingEngine->renderResponse('custom.html.twig');
+            return new Response($this->twig->render('custom.html.twig'));
         }
     }
 
@@ -192,7 +175,7 @@ If you still need the methods of the original ``HomepageController``, then copy
     services:
         sylius.controller.shop.homepage:
             class: App\Controller\Shop\HomepageController
-            arguments: ['@templating']
+            arguments: ['@twig']
             tags: ['controller.service_arguments']
 
 .. tip::