Various docblock cleanup

Author: tyler-sommer

src/Application.php

@@ -32,7 +32,7 @@
 use Symfony\Component\HttpKernel\TerminableInterface;
 
 /**
- * An Application
+ * A Nice Application
  */
 class Application implements HttpKernelInterface, ContainerInterface, ExtendableInterface
 {

src/DependencyInjection/CacheRoutingDataPass.php

@@ -13,6 +13,10 @@
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Reference;
 
+/**
+ * Overrides the default RouteCollector and URL DataGenerator with
+ * cache-based implementations.
+ */
 class CacheRoutingDataPass implements CompilerPassInterface
 {
     /**

src/DependencyInjection/ContainerInitializer/CachedInitializer.php

@@ -18,6 +18,9 @@
 use Symfony\Component\DependencyInjection\Dumper\PhpDumper;
 use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 
+/**
+ * Wraps a ContainerInitializer, providing a file-based cache for the built container
+ */
 class CachedInitializer implements ContainerInitializerInterface
 {
     /**

src/DependencyInjection/ContainerInitializer/DefaultInitializer.php

@@ -20,6 +20,9 @@
 use Symfony\Component\HttpKernel\DependencyInjection\MergeExtensionConfigurationPass;
 use Symfony\Component\HttpKernel\DependencyInjection\RegisterListenersPass;
 
+/**
+ * Creates and initializes a Service Container, ready for use by the Application
+ */
 class DefaultInitializer implements ContainerInitializerInterface
 {
     /**

src/DependencyInjection/ContainerInitializerInterface.php

@@ -14,6 +14,12 @@
 use Symfony\Component\DependencyInjection\ContainerInterface;
 use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 
+/**
+ * Defines the contract any ContainerInitializer must follow
+ *
+ * A ContainerInitializer is responsible for creating a DependencyInjection Container
+ * and readying it for use by a Nice Application
+ */
 interface ContainerInitializerInterface
 {
     /**

src/DependencyInjection/ExtendableInterface.php

@@ -12,7 +12,7 @@
 use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 
 /**
- * Defines the contract any Extendable object should implement
+ * Defines the contract any Extendable object must implement
  */
 interface ExtendableInterface
 {

src/Extension/CacheExtension.php

@@ -14,7 +14,7 @@
 use Symfony\Component\DependencyInjection\Reference;
 
 /**
- * Sets up Cache services
+ * Sets up Doctrine Cache services
  */
 class CacheExtension extends Extension
 {

src/Extension/RouterExtension.php

@@ -15,7 +15,7 @@
 use Symfony\Component\DependencyInjection\Extension\Extension;
 
 /**
- * Sets up FastRoute services
+ * Sets up routing related services
  */
 class RouterExtension extends Extension
 {

src/Router/NamedDataGenerator/HandlerWrapperGenerator.php

@@ -12,13 +12,21 @@
 use FastRoute\DataGenerator;
 use Nice\Router\NamedDataGeneratorInterface;
 
+/**
+ * HandlerWrapperGenerator adds extra metadata to routes to support named routes
+ */
 class HandlerWrapperGenerator implements NamedDataGeneratorInterface
 {
     /**
      * @var \FastRoute\DataGenerator
      */
     private $wrappedGenerator;
 
+    /**
+     * Constructor
+     *
+     * @param DataGenerator $wrappedGenerator
+     */
     public function __construct(DataGenerator $wrappedGenerator)
     {
         $this->wrappedGenerator = $wrappedGenerator;

src/Router/NamedDataGeneratorInterface.php

@@ -11,6 +11,11 @@
 
 use FastRoute\DataGenerator;
 
+/**
+ * Defines the contract any NamedDataGenerator must implement
+ *
+ * A NamedDataGenerator special DataGenerator that can handle named routes
+ */
 interface NamedDataGeneratorInterface extends DataGenerator
 {
     /**