diff --git a/core/lib/Drupal/Core/Routing/RouteProvider.php b/core/lib/Drupal/Core/Routing/RouteProvider.php
index 63fb7014e662..f2aea92e50e9 100644
--- a/core/lib/Drupal/Core/Routing/RouteProvider.php
+++ b/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 {
 
diff --git a/core/lib/Drupal/Core/Routing/UrlMatcher.php b/core/lib/Drupal/Core/Routing/UrlMatcher.php
index 5c06235e2ec7..1e302bdf7124 100644
--- a/core/lib/Drupal/Core/Routing/UrlMatcher.php
+++ b/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 {