Add docs for new routebuilder option.

en/appendices/3-5-migration-guide.rst

@@ -41,6 +41,9 @@ New Features
 * ``Cake\Routing\Router::reverseToArray()`` was added. This method allow you to
   convert a request object into an array that can be used to generate URL
   strings.
+* ``Cake\Routing\RouteBuilder::resources()`` had the ``path`` option
+  added. This option lets you make the resource path and controller name not
+  match.
 * New abstract types were added for ``smallinteger`` and ``tinyinteger``.
   Existing ``SMALLINT`` and ``TINYINT`` columns will now be reflected as these
   new abstract types. ``TINYINT(1)`` columns will continue to be treated as

en/development/routing.rst

@@ -942,14 +942,27 @@ You can specify an alternative inflection type using the ``inflect`` option::
         ]);
     });
 
-The above will generate URLs styled like: **/blog-posts/\***.
+The above will generate URLs styled like: **/blog-posts**.
 
 .. note::
 
     As of CakePHP 3.1 the official app skeleton uses ``DashedRoute`` as its
     default route class. Using the ``'inflect' => 'dasherize'`` option when
     connecting resource routes is recommended for URL consistency.
 
+Changing the Path Element
+-------------------------
+
+By default resource routes use an inflected form of the resource name for the
+URL segment. You can set a custom URL segment with the ``path`` option::
+
+    Router::scope('/', function ($routes) {
+        $routes->resources('BlogPosts', ['path' => 'posts']);
+    });
+
+.. versionadded:: 3.5.0
+    The ``path`` option was added in 3.5.0
+
 .. index:: passed arguments
 .. _passed-arguments: