diff --git a/README.md b/README.md
index 7b94c46..2010ddd 100644
--- a/README.md
+++ b/README.md
@@ -39,4 +39,102 @@ to the "require" section of your composer.json.
Usage
-----
-This extension allows integration with PSR compatible logger for Yii1.
\ No newline at end of file
+This extension allows integration with PSR compatible logger for Yii1.
+It provides several instruments for that. Please choose the one suitable for your particular needs.
+
+
+## Wrap PSR logger into Yii logger
+
+The most common use case for PSR logger involvement into Yii application is usage of 3rd party log library like [Monolog](https://github.com/Seldaek/monolog).
+This can be achieved using `\yii1tech\psr\log\Logger` instance as Yii logger. Its instance should be passed to `\Yii::setLogger()`
+before the application instantiation.
+
+Application entry script example:
+
+```php
+setPsrLogger(function () {
+ // use Monolog as internal PSR logger:
+ $log = new \Monolog\Logger('yii');
+ $log->pushHandler(new \Monolog\Handler\StreamHandler('path/to/your.log', \Monolog\Level::Warning));
+
+ return $log;
+ })
+ ->enableYiiLog(true) // whether to continue passing logs to standard Yii log mechanism or not
+);
+
+// create and run Yii application:
+Yii::createWebApplication($config)->run();
+```
+
+`\yii1tech\psr\log\Logger` passes all messages logged via `Yii::log()` to the related PSR logger, which stores them according to its
+own internal logic.
+
+Also, usage of `\yii1tech\psr\log\Logger` grands you several additional benefits:
+
+- It allows usage of `\Psr\log\LogLevel` constants for log level specification instead of `\CLogger` ones.
+- It allows passing log context as array as a 3rd argument of the `Yii::log()` method, and saving it into Yii logs.
+
+For example:
+
+```php
+ 'bar', // specifying log context, which will be passed to the related PSR logged, and added as JSON to the Yii log message, if it is enabled
+]);
+
+try {
+ // ...
+} catch (\Throwable $exception) {
+ Yii::log('context exception', LogLevel::ERROR, [
+ 'exception' => $exception, // exception data such as class, message, file, line and so on will be logged
+ ]);
+}
+```
+
+
+## PSR Log Route
+
+Application configuration example:
+
+```php
+ [
+ 'log' => [
+ 'class' => \CLogRouter::class,
+ 'routes' => [
+ [
+ 'class' => \yii1tech\psr\log\PsrLogRoute::class,
+ 'psrLogger' => function () {
+ $log = new \Monolog\Logger('yii');
+ $log->pushHandler(new \Monolog\Handler\StreamHandler('path/to/your.log', \Monolog\Level::Warning));
+
+ return $log;
+ },
+ ],
+ // ...
+ ],
+ ],
+ // ...
+ ],
+ // ...
+];
+```
+
+
+## Wrap Yii logger into PSR logger
diff --git a/src/Logger.php b/src/Logger.php
index 047b13c..0b93233 100644
--- a/src/Logger.php
+++ b/src/Logger.php
@@ -18,8 +18,7 @@
* require __DIR__ . '../vendor/autoload.php';
* // ...
*
- * $app = Yii::createWebApplication($config);
- * $app->setLogger(
+ * Yii::setLogger(
* \yii1tech\psr\log\Logger::new()
* ->setPsrLogger(function () {
* $log = new \Monolog\Logger('yii');
@@ -29,7 +28,8 @@
* })
* ->enableYiiLog(true)
* );
- * $app->run();
+ *
+ * Yii::createWebApplication($config)->run();
* ```
*
* @property \Psr\Log\LoggerInterface|\Closure|string|array|null $psrLogger related PSR logger.