diff --git a/README.md b/README.md
index 165be80..9dbf569 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,15 @@
* Prometheus datasource
* Tested with Grafana 5.1.3
+## Installation
+
+Plugin can be installed with git:
+
+```
+git clone git@github.com:flant/grafana-statusmap.git /var/lib/grafana/plugins/flant-statusmap-panel
+```
+
+Or you can download ZIP archive of this repo and unpack it into /var/lib/grafana/plugins directory.
## Motivation
@@ -25,7 +34,33 @@ of predefined values: something like `ok` = 0, `off` = 1, `fail` = 2.
## Configuration
-Recommended setup is to create query for each possible status value with similar legend:
+### Prometheus
+
+Discrete statuses requires some setup in prometheus to get all available statuses over time.
+If metric has values 0 and 1 and status is stored in label then it's ok. But if there are 5 statuses
+and metric has possible values (0,1,2,3,4) then it should be transformed into previous form with this rule:
+
+```
+- record: coffee_maker_status:discrete
+ expr: |
+ count_values("status", coffee_maker_status)
+
+```
+
+This rule will transform metric `coffee_maker_status` with value `3` into this new metric:
+
+```
+coffee_maker_status:discrete{status="3"} 1
+```
+
+Now prometheus has 0 and 1 for each status. And these metrics can be aggregated
+to get all available statuses over time.
+
+### Panel
+
+Each possible status value corresponds to a separate query. Each query should have similar legend for grouping.
+
+

@@ -51,7 +86,7 @@ __Null values__ can be treated as empty buckets or displayed as color of 0 value

-__Min width__ and __spacing__ are determine minimal bucket width and vertical and horizontal spacing between buckets.
+__Min width__ and __spacing__ are determine minimal bucket width and spacing between buckets.
__Rounding__ is for round edges.

@@ -77,7 +112,7 @@ grunt watch
## Acknowledgements
-Idea of a plugin comes from Dmitry Stolyarov @distol, initial version written by Sergey Gnuskov @gsmetal and final changes made by Ivan Mikheykin @diafour.
+Idea of a plugin comes from Dmitry Stolyarov [@distol](https://github.com/distol), initial version written by Sergey Gnuskov [@gsmetal](https://github.com/gsmetal) and final changes made by Ivan Mikheykin [@diafour](https://github.com/diafour).
This plugin is based on a "Heatmap" panel by Grafana and inspired by ideas from Carpet plot, Discrete panel, Status Panel, Status Dot, Status By Group.
diff --git a/dist/README.md b/dist/README.md
index 165be80..e38d659 100644
--- a/dist/README.md
+++ b/dist/README.md
@@ -15,6 +15,15 @@
* Prometheus datasource
* Tested with Grafana 5.1.3
+## Installation
+
+Plugin can be installed with git:
+
+```
+git clone git@github.com:flant/grafana-statusmap.git /var/lib/grafana/plugins/flant-statusmap-panel
+```
+
+Or you can download ZIP archive of this repo and unpack it into /var/lib/grafana/plugins directory.
## Motivation
@@ -51,7 +60,7 @@ __Null values__ can be treated as empty buckets or displayed as color of 0 value

-__Min width__ and __spacing__ are determine minimal bucket width and vertical and horizontal spacing between buckets.
+__Min width__ and __spacing__ are determine minimal bucket width and spacing between buckets.
__Rounding__ is for round edges.

diff --git a/dist/img/logo.svg b/dist/img/logo.svg
index 2bedb4c..d401c33 100644
--- a/dist/img/logo.svg
+++ b/dist/img/logo.svg
@@ -1,3 +1,46 @@
-
-
-
+
+
+
+
diff --git a/dist/img/queries-example.png b/dist/img/queries-example.png
index 1115ee2..041567b 100644
Binary files a/dist/img/queries-example.png and b/dist/img/queries-example.png differ
diff --git a/src/img/logo.svg b/src/img/logo.svg
index 2bedb4c..d401c33 100644
--- a/src/img/logo.svg
+++ b/src/img/logo.svg
@@ -1,3 +1,46 @@
-
-
-
+
+
+
+
diff --git a/src/img/queries-example.png b/src/img/queries-example.png
index 1115ee2..7150b44 100644
Binary files a/src/img/queries-example.png and b/src/img/queries-example.png differ