Merge branch 'master' of github.com:/noglitchyo/middleware-collection-request-handler

Author: noglitchyo

README.md

@@ -32,23 +32,23 @@ It comes with a set of middleware collections using different strategy on how to
 
 #### Run
 
-Instantiate the RequestHandler class. It requires ony 2 arguments:
+Instantiate the RequestHandler class. It requires ony 2 arguments: 
 
-- `$defaultRequestHandler` ([RequestHandlerInterface](https://github.com/php-fig/http-server-handler/blob/master/src/RequestHandlerInterface.php))
+- ***`$defaultRequestHandler`*** : [RequestHandlerInterface](https://github.com/php-fig/http-server-handler/blob/master/src/RequestHandlerInterface.php)
 
-***The default request handler is responsible to provide a default response if none of the middlewares created one.***
+    ***The default request handler MUST provide a default response if none of the middlewares created one.***
 
-Some examples of "default request handler": 
-- with the [ADR pattern](https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder), the default request handler might be your action class.
-- with the [MVC pattern](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller), the default request handler might be the action method of your controller.
+    Some examples of what could be a "default request handler":
+    - with the [ADR pattern](https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder), the default request handler might be your action class.*
+    - with the [MVC pattern](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller), the default request handler might be the action method of your controller.
 
-It is possible to directly provide a `callable` and use the factory method `RequestHandler::fromCallable(callable $callable)`. 
-It will create an anonymous instance of RequestHandlerInterface wrapping the given `callable` inside.
+    It is possible to directly provide a `callable` and use the factory method `RequestHandler::fromCallable(callable $callable)`. 
+    It will create an anonymous instance of RequestHandlerInterface wrapping the given `callable` inside.
 
-- `$middlewareCollection` ([MiddlewareCollectionInterface](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/MiddlewareCollectionInterface.php))
+- ***`$middlewareCollection`*** : [MiddlewareCollectionInterface](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/MiddlewareCollectionInterface.php)
 
-Contains the middlewares and encapsulate the strategy used to store and retrieve the middlewares.
-Some standard implementations are provided with different strategies: [stack (LIFO)](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/Collection/SplStackMiddlewareCollection.php), [queue (FIFO)](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/Collection/SplQueueMiddlewareCollection.php).
+    Contains the middlewares and defines the strategy used to store the middlewares and to retrieve the next middleware.
+    Some implementations with common strategies are provided: [stack (LIFO)](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/Collection/SplStackMiddlewareCollection.php), [queue (FIFO)](https://github.com/noglitchyo/middleware-collection-request-handler/blob/master/src/Collection/SplQueueMiddlewareCollection.php).
 
 ##### Example
 
@@ -63,7 +63,8 @@ use Psr\Http\Message\ServerRequestInterface;
 use Psr\Http\Server\RequestHandlerInterface;
 use Psr\Http\Message\ResponseInterface;
 
-// Instantiate a collection of middleware.
+// Instantiate a collection of middlewares with an anonymous middleware class.
+// In this example, we are using a "stack" implementation of the collection.
 $middlewareCollection = new SplStackMiddlewareCollection([
     new class implements MiddlewareInterface{
         public function process(ServerRequestInterface $request, RequestHandlerInterface $handler) : ResponseInterface{
@@ -85,7 +86,7 @@ $requestHandler = RequestHandler::fromCallable(
     $middlewareCollection
 );
 
-// Pass the request to the request handler.
+// Pass the request to the request handler which will dispatch the request to the middlewares.
 $response = $requestHandler->handle(/* ServerRequestInterface */); 
 
 ```