From 163ed67967447cdec527db4bf57349a48343b749 Mon Sep 17 00:00:00 2001
From: Chemaclass <chemaclass@outlook.es>
Date: Fri, 21 Apr 2023 14:51:58 +0200
Subject: [PATCH] Improve readme example

---
 README.md | 37 ++++++++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 3860240..7b11797 100644
--- a/README.md
+++ b/README.md
@@ -36,26 +36,37 @@ composer require gacela-project/router
 
 ### Example
 
-Start the example local server:
-```bash
-php -S localhost:8081 example/example.php
-```
-
-You can access the example routes:
 ```php
-# file: example/example.php
-Router::configure(static function (Routes $routes, Bindings $bindings) void {
-    # http://localhost:8081/docs
+# `Bindings` and `Handlers` are optional, and you can place them in any order.
+
+Router::configure(static function (Routes $routes, Bindings $bindings, Handlers $handlers) void {
+
+    // Custom redirections
     $routes->redirect('docs', 'https://gacela-project.com/');
+    
+    // Matching a route coming from a particular or any custom HTTP methods
+    $routes->get('custom', CustomController::class, '__invoke');
+    $routes->...('custom', CustomController::class, 'customAction');
+    $routes->any('custom', CustomController::class);
 
-    # http://localhost:8081?number=456
+    // Matching a route coming from multiple HTTP methods
     $routes->match(['GET', 'POST'], '/', CustomController::class);
     
-    # http://localhost:8081/custom/123
+    // Binding custom dependencies on your controllers
     $routes->get('custom/{number}', CustomControllerWithDependencies::class, 'customAction');
     $bindings->bind(SomeDependencyInterface::class, SomeDependencyConcrete::class)
 
-    # http://localhost:8081/custom
-    $routes->any('custom', CustomController::class);
+    // Handle custom Exceptions with class-string|callable
+    $handlers->handle(NotFound404Exception::class, NotFound404ExceptionHandler::class);
+
 });
 ```
+
+### Working demo
+
+For a working example run `composer serve` and check the `example/example.php`
+
+> TIP: `composer serve` is equivalent to:
+> ```bash
+> php -S localhost:8081 example/example.php
+> ```