minor #10554 Minor reword of AbstractController vs Controller (javiereguiluz)

javiereguiluz · javiereguiluz · commit 698495105ded · 2018-10-26T16:27:31.000+02:00
This PR was merged into the 3.4 branch. Discussion ---------- Minor reword of AbstractController vs Controller This fixes #9926. Commits ------- 5bee7d9 Minor reword of AbstractController vs Controller
diff --git a/controller.rst b/controller.rst
@@ -147,10 +147,12 @@ and many others that you'll learn about next.
 .. tip::
 
     You can extend either ``Controller`` or ``AbstractController``. The difference
-    is that when you extend ``AbstractController``, you can't access services directly
-    via ``$this->get()`` or ``$this->container->get()``. This forces you to write
-    more robust code to access services. But if you *do* need direct access to the
-    container, using ``Controller`` is fine.
+    is that when you extend ``AbstractController``, you can't access to your services
+    via ``$this->get()`` or ``$this->container->get()``, only to a set of common
+    Symfony services. This forces you to write more robust code to access services.
+
+    Moreover, in Symfony 4.2 ``Controller`` was deprecated in favor of
+    ``AbstractController``, so using the latter will make your apps future-proof.
 
 .. versionadded:: 3.3
     The ``AbstractController`` class was added in Symfony 3.3.
