Update controllers.rst

Added useful debug commands in the debug documentation

Merged two commands to shorten the file

Fixed bash -> terminal code blocks

Updated the command examples to be a list instead pieces of text with large terminal graphics

Revert accidental commit

Author: asandjivy

best_practices/controllers.rst

@@ -85,10 +85,10 @@ it more difficult to know which template is being rendered. It also makes
 it less obvious to beginners that a controller should always return a Response
 object (unless you're using a view layer).
 
-What does the Controller look like
-----------------------------------
+How the Controller Looks
+------------------------
 
-Considering all this, here is an example of what the controller should look like
+Considering all this, here is an example of how the controller should look
 for the homepage of our app:
 
 .. code-block:: php

debug/debugging.rst

@@ -59,3 +59,29 @@ locations. To avoid problems, you can either tell your IDE to ignore the PHP
 cache files, or you can change the extension used by Symfony for these files::
 
     $kernel->loadClassCache('classes', '.php.cache');
+
+Useful debugging commands
+-------------------------
+
+When developing a large application, it can be hard to keep track of all the
+different services, routes and translations. Luckily, Symfony has some commands
+that can help you visualize and find the information.
+
+``debug:container``
+    Displays about the contents of the Symfony container for all public
+    services. To find only those matching a name, append the name as an argument.
+
+``debug:config``
+    Shows all configured bundles, their class and their alias.
+
+``debug:router``
+    Displays information about all configured routes in the application as a
+    table with the name, method, scheme, host and path for each route.
+
+``debug:translation <locale>``
+    Shows a table of the translation key, the domain, the translation and the
+    fallback translation for all known messages, if translations exist for
+    the given locale.
+
+When in doubt how to use a console command, open the help section by appending
+the ``--help`` option.