TASK: Add more descriptive readme

README.md

@@ -1,12 +1,81 @@
 Monolog Integration for Flow
 ============================
 
-Provides a monolog factory ready for Flow 5.0.
-Also replaces all Neos logs (Security, System, Query, I18n) with Monolog by default.
-To change that and the handlers check the Settings.yaml.
+Provides a [monolog](https://github.com/Seldaek/monolog) factory to be used with Flow.
+
+❗ 
+> This package replaces all Neos Flow logs (Security, System, Query, I18n) with Monolog by default.
+> To change that and the handlers check the Settings.yaml. See also configuration notes below.
+
+ 👻
 
-For more information about Handlers check also the monolog package.
-
 > The monolog format is slightly different than the default Flow log file format, 
-> also the configured monolog handler does no log rotation like the Flow log does, 
+> also the configured monolog handler does **no log rotation** like the Flow log does, 
 > so you need to take care of that.
+
+
+Installation
+------------
+Use composer to install this package:
+
+`composer install flowpack/monolog`
+
+All Framework logs should now be in monolog format and you need to add configuration for any other logs you might want.
+
+Configuration
+-------------
+
+You have several ways to configure monolog with this package, the easiest is seen in the configuration for the Neos Flow logs in this package:
+
+```
+Neos:
+  Flow:
+    log:
+      psr3:
+        'Flowpack\Monolog\LoggerFactory':
+          # name of the logger as flow addresses it, eg. "systemLogger"
+          '<name of the logger>':
+            handler:
+              # unique name for this handler in this log, for extending the configuration
+              '<identifier for this handler>':
+                className: '<monolog compatible handler class name fully qualified>'
+                # sorting for this handler if you want it deterministic with overwrites
+                position: 100
+                # arguments given to the handler, zero index based, as the hander constructor expects them
+                arguments:
+                  0: '<the first argument given to the constructor of the handler>'
+              # another handler could follow here
+```
+
+Another option is to create preset handlers, eg. if you need to use the same handler with the same configuration in multiple places, no overrides of this default configuration is possible at this time:
+
+```
+Flowpack:
+  Monolog:
+    handler:
+      # unique identifier of this handler (preset)
+      '<presetName>':
+        className: '<monolog compatible handler class name fully qualified>'
+        # note that preset handlers currently cannot have a position, they are sorted as configured
+        # arguments given to the handler, zero index based, as the hander constructor expects them
+        arguments:
+            0: '<the first argument given to the constructor of the handler>'
+
+Neos:
+  Flow:
+    log:
+      psr3:
+        'Flowpack\Monolog\LoggerFactory':
+          # name of the logger as flow addresses it, eg. "systemLogger"
+          '<name of the logger>':
+            handler:
+              # the presetName should be the same as in above preset configuration
+              '<identifier for this handler>': '<presetName>'
+```
+
+
+Handlers
+--------
+
+For more information about handlers and their configuration check also the [monolog](https://github.com/Seldaek/monolog) package.
+