Merge pull request #17724 from cakephp/docblocks

Update/fix docblocks.

src/Routing/RouteBuilder.php

@@ -28,10 +28,7 @@ use InvalidArgumentException;
 use Psr\Http\Server\MiddlewareInterface;
 
 /**
- * Provides features for building routes inside scopes.
- *
- * Gives an easy to use way to build routes and append them
- * into a route collection.
+ * Provides features for building routes and parsing/matching URLs to routes.
  */
 class RouteBuilder
 {

src/Routing/Router.php

@@ -32,12 +32,6 @@ use Throwable;
  * to match the incoming URL string to parameters that will allow the request to be dispatched. Also
  * handles converting parameter lists into URL strings, using the connected routes. Routing allows you to decouple
  * the way the world interacts with your application (URLs) and the implementation (controllers and actions).
- *
- * ### Connecting routes
- *
- * Connecting routes is done using Router::connect(). When parsing incoming requests or reverse matching
- * parameters, routes are enumerated in the order they were connected. For more information on routes and
- * how to connect them see Router::connect().
  */
 class Router
 {