Documentation improvements.

core/lib/Drupal/Core/Routing/RouteProvider.php

@@ -1,5 +1,9 @@
 <?php
 
+/**
+ * @file
+ * Contains Drupal\Core\Routing\RouteProvider.
+ */
 
 namespace Drupal\Core\Routing;
 
@@ -11,7 +15,7 @@ use Symfony\Component\Routing\Exception\ResourceNotFoundException;
 use \Drupal\Core\Database\Connection;
 
 /**
- *
+ * A Route Provider front-end for all Drupal-stored routes.
  */
 class RouteProvider implements RouteProviderInterface {
 

core/lib/Drupal/Core/Routing/UrlMatcher.php

@@ -8,9 +8,7 @@ use Symfony\Component\Routing\RequestContext;
 use Symfony\Cmf\Component\Routing\NestedMatcher\UrlMatcher as BaseUrlMatcher;
 
 /**
- * Description of UrlMatcher
- *
- * @author crell
+ * Drupal-specific URL Matcher; handles the Drupal "system path" mapping.
  */
 class UrlMatcher extends BaseUrlMatcher {