Documenting the reason for the MiddlewareController to exist

Author: Ocramius

src/Controller/MiddlewareController.php

@@ -22,10 +22,13 @@
 use Zend\Stratigility\MiddlewarePipe;
 
 /**
- * Note: I'm a terrible person
- *
  * @internal don't use this in your codebase, or else @ocramius will hunt you down. This is just an internal
  * @internal hack to make middleware trigger 'dispatch' events attached to the DispatchableInterface identifier.
+ *
+ * Specifically, it will receive a @see MiddlewarePipe, a @see ResponseInterface prototype, and then dispatch
+ * the pipe whilst still behaving like a normal controller. That is needed for any events attached to
+ * the @see \Zend\Stdlib\DispatchableInterface identifier to reach their listeners on any attached
+ * @see \Zend\EventManager\SharedEventManagerInterface
  */
 final class MiddlewareController extends AbstractController
 {