Document event hooks

Author: adiachenko

readme.md

@@ -140,6 +140,32 @@ Route::get('/users', 'UserController@index');
 
 That's it! Now serve the application with `php artisan serve` and visit `http://localhost:8000/users`
 
+### Event Hooks
+
+Lucid exposes event hooks that allow you to listen on each dispatched feature, operation or job. This is especially useful for tracing:
+
+```php
+use Illuminate\Support\Facades\Event;
+use Lucid\Foundation\Events\FeatureStarted;
+use Lucid\Foundation\Events\OperationStarted;
+use Lucid\Foundation\Events\JobStarted;
+
+Event::listen(FeatureStarted::class, function (FeatureStarted $event) {
+    // $event->name
+    // $event->arguments
+});
+
+Event::listen(OperationStarted::class, function (OperationStarted $event) {
+    // $event->name
+    // $event->arguments
+});
+
+Event::listen(JobStarted::class, function (JobStarted $event) {
+    // $event->name
+    // $event->arguments
+});
+```
+
 ---
 
 ## Monolith vs. Microservice
@@ -172,33 +198,3 @@ and work on it until it gets so big that it is crucial to be dissected into sing
 It would be challenging to be able to figure out the different services your application would need moving forward.
 
 This project is also useful when you know for sure that your application will not have to deal with multiple Services but you would still like to use Lucid.
-
----
-
-# Laravel PHP Framework
-
-[![Build Status](https://travis-ci.org/laravel/framework.svg)](https://travis-ci.org/laravel/framework)
-[![Total Downloads](https://poser.pugx.org/laravel/framework/d/total.svg)](https://packagist.org/packages/laravel/framework)
-[![Latest Stable Version](https://poser.pugx.org/laravel/framework/v/stable.svg)](https://packagist.org/packages/laravel/framework)
-[![Latest Unstable Version](https://poser.pugx.org/laravel/framework/v/unstable.svg)](https://packagist.org/packages/laravel/framework)
-[![License](https://poser.pugx.org/laravel/framework/license.svg)](https://packagist.org/packages/laravel/framework)
-
-Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable, creative experience to be truly fulfilling. Laravel attempts to take the pain out of development by easing common tasks used in the majority of web projects, such as authentication, routing, sessions, queueing, and caching.
-
-Laravel is accessible, yet powerful, providing tools needed for large, robust applications. A superb inversion of control container, expressive migration system, and tightly integrated unit testing support give you the tools you need to build any application with which you are tasked.
-
-## Official Documentation
-
-Documentation for the framework can be found on the [Laravel website](http://laravel.com/docs).
-
-## Contributing
-
-Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](http://laravel.com/docs/contributions).
-
-## Security Vulnerabilities
-
-If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell at taylor@laravel.com. All security vulnerabilities will be promptly addressed.
-
-## License
-
-The Laravel framework is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).