class headers for Dispatcher, Request and Response

libraries/lithium/action/Dispatcher.php

@@ -14,6 +14,18 @@
 use \lithium\core\Libraries;
 use \lithium\core\Environment;
 
+/**
+ * `Dispatcher` is the outermost layer of the framework (including app), responsible for both
+ * recieving the initial http request and sending back the response at the end of the cycle.
+ *
+ * After interpreting the request and making a `Request` instance, it initiates the correct
+ * `Controller` and passes it the `Request` object. When the `Controller` returns a `Response`,
+ * `Dispatcher`, where the headers and content are rendered and sent to the browser.
+ *
+ * @see lithium\action\request
+ * @see lithium\action\response
+ * @see lithium\action\controller
+ */
 class Dispatcher extends \lithium\core\StaticObject {
 
 	/**

libraries/lithium/action/Request.php

@@ -10,6 +10,11 @@
 
 use \lithium\util\Validator;
 
+/**
+ * Request is responsible for identifying and storing all the information about the http request.
+ *
+ * @see lithium\action\Dispatcher
+ */
 class Request extends \lithium\core\Object {
 
 	public $url = null;

libraries/lithium/action/Response.php

@@ -10,6 +10,13 @@
 
 use \Exception;
 
+/**
+ * The `Response` instance is what the `Controller` returns to the `Dispatcher` as the product
+ * of the view layer. See related classes for more details.
+ *
+ * @see lithium\action\Dispatcher
+ * @see lithium\action\Controller
+ */
 class Response extends \lithium\http\Response {
 
 	protected $_config = array();