feat: update docs

Author: hartym

_includes/links.html

@@ -1,11 +1,5 @@
 <li>
-    <a href="https://www.bonobo-project.org/" target="_blank">Bonobo (extract transform load)</a>
-</li>
-<li>
-    <a href="https://python-medikit.github.io/" target="_blank">Medikit (release management)</a>
-</li>
-<li>
-    <a href="https://python-mondrian.github.io/" target="_blank">Mondrian (logging simplified)</a>
+    <a href="https://harp-proxy.net/" target="_blank">HARP Proxy (http proxy for APIs)</a>
 </li>
 <li>
     <a href="https://python-whistle.github.io/" target="_blank">Whistle (event dispatcher)</a>

_includes/topnav.html

@@ -14,7 +14,7 @@
         <div id="navbar" class="collapse navbar-collapse">
             <div class="navbar-right">
                 <ul class="nav navbar-nav">
-                    <li><a href="#documentation"><i class="fa fa-book" aria-hidden="true"></i> Documentation</a></li>
+                    <li><a href="https://python-whistle.readthedocs.io/" target="_blank"><i class="fa fa-book" aria-hidden="true"></i> Documentation</a></li>
                     <li><a href="{{ site.git_address }}" target="_blank"><i class="fa fa-github" aria-hidden="true"></i> Sources</a></li>
                 </ul>
             </div>

index.html

@@ -21,7 +21,7 @@ <h2>Event Dispatcher for Python</h2>
         <p class="text-center">
             <a class="btn btn-primary btn-lg" href="https://pypi.org/project/whistle/" target="_blank"
                role="button">Install</a>
-            <a class="btn btn-primary btn-outline-inverse btn-lg" href="#documentation"
+            <a class="btn btn-primary btn-outline-inverse btn-lg" href="https://python-whistle.readthedocs.io/" target="_blank"
                role="button">Documentation</a>
         </p>
     </div>
@@ -35,14 +35,14 @@ <h2>Event Dispatcher for Python</h2>
             <h2 class="header-light regular-pad">What is Whistle?</h2>
             <blockquote>
                 <p>
-                    Whistle is an Event Dispatcher library for the Python 3.5+ language.
+                    Whistle is a lightweight Event Dispatcher library for Python 3.10+ that enables decoupled application communication through event dispatching and listening.
                 </p>
                 <p>
                     It's largely inspired from Symfony's EventDispatcher component.
                 </p>
                 <p>
                     Using an event dispatcher is a great way to write loosely coupled extensible code, having each part
-                    only communicate using light events.
+                    only communicate using light events, making your code more modular, testable, and maintainable.
                 </p>
             </blockquote>
         </div>
@@ -66,6 +66,26 @@ <h2 class="header-light regular-pad">What is Whistle?</h2>
 
     <hr>
 
+    <div class="row">
+        <h2>Key Features</h2>
+        <div class="col-md-6">
+            <ul>
+                <li><strong>Synchronous and asynchronous dispatching</strong> - Choose the right dispatcher for your use case</li>
+                <li><strong>Priority-based listener execution</strong> - Control the order listeners run</li>
+                <li><strong>Event propagation control</strong> - Stop event flow when needed</li>
+            </ul>
+        </div>
+        <div class="col-md-6">
+            <ul>
+                <li><strong>Type safety</strong> - Prevent mixing sync and async listeners</li>
+                <li><strong>Custom events</strong> - Attach domain-specific data to events</li>
+                <li><strong>Zero dependencies</strong> - Lightweight and easy to integrate</li>
+            </ul>
+        </div>
+    </div>
+
+    <hr>
+
     <div class="row">
         <h2>Quick start</h2>
 
@@ -86,9 +106,17 @@ <h3>Add a listener to react to events</h3>
 
 dispatcher.add_listener('spectacle.starts', on_spectacle_starts)</code></pre>
 
+        <p>Or use the decorator syntax for convenience:</p>
+
+        <pre><code class="python">@dispatcher.listen('spectacle.starts')
+def on_spectacle_starts(event):
+    print('Please turn down your phones!')
+</code></pre>
+
         <h3>Dispatch it!</h3>
 
-        <pre><code class="python">dispatcher.dispatch('spectacle.starts')</code></pre>
+        <pre><code class="python">dispatcher.dispatch('spectacle.starts')
+# Output: Please turn down your phones!</code></pre>
 
 
     </div>