Tweaks

Author: javiereguiluz

controller/service.rst

@@ -78,16 +78,16 @@ syntax:
 Invokable Controllers
 ---------------------
 
-If your controller implements the ``__invoke()`` method - popular with the
-Action-Domain-Response (ADR) pattern, you can simply refer to the service id
-(e.g. ``AppBundle\Controller\HelloController`` or ``app.hello_controller``)::
+Controllers can also define a single action using the ``__invoke()`` method,
+which is a common practice when following the `ADR pattern`_
+(Action-Domain-Responder)::
 
     // src/AppBundle/Controller/Hello.php
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     /**
-     * @Route("/hello/{name}", name="hello", service="AppBundle\Controller\Hello")
+     * @Route("/hello/{name}", name="hello")
      */
     class Hello
     {
@@ -154,3 +154,4 @@ If you want to know what type-hints to use for each service, see the
 .. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/ControllerTrait.php
 .. _`ControllerTrait`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/ControllerTrait.php
 .. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
+.. _`ADR pattern`: https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder