Merge pull request #1012 from cakephp/5.next-update-routes-doc

5.next: update routes doc

Author: markstory

config/routes.php

@@ -26,8 +26,8 @@
 
 /*
  * This file is loaded in the context of the `Application` class.
-  * So you can use  `$this` to reference the application class instance
-  * if required.
+ * So you can use `$this` to reference the application class instance
+ * if required.
  */
 return function (RouteBuilder $routes): void {
     /*
@@ -72,8 +72,8 @@
          * $builder->connect('/{controller}/{action}/*', []);
          * ```
          *
-         * You can remove these routes once you've connected the
-         * routes you want in your application.
+         * It is NOT recommended to use fallback routes after your initial prototyping phase!
+         * See https://book.cakephp.org/5/en/development/routing.html#fallbacks-method for more information
          */
         $builder->fallbacks();
     });