Upd docs

Author: antonmyronyuk

README.md

@@ -19,7 +19,7 @@ s = Summary("request_latency_seconds", "Description of summary")
 s.observe(4.7)
 ```
 
-### With labels
+### Usage with labels
 
 ```python
 from prometheus_summary import Summary
@@ -29,11 +29,13 @@ s.labels(method="GET", endpoint="/profile").observe(1.2)
 s.labels(method="POST", endpoint="/login").observe(3.4)
 ```
 
-### With custom quantiles and precisions
+### Usage with custom quantiles and precisions
+
+By default, metrics are observed for the following (quantile, precision (inaccuracy)) pairs:
 
-By default, metrics are observed for next (quantile, precision (inaccuracy)) pairs
 `((0.50, 0.05), (0.90, 0.01), (0.99, 0.001))`
-but you can provide your own values when creating the metric.
+
+You can also provide your own values when creating the metric.
 
 ```python
 from prometheus_summary import Summary
@@ -45,13 +47,13 @@ s = Summary(
 s.observe(4.7)
 ```
 
-### With custom time window settings
+### Usage with custom time window settings
 
 Typically, you don't want to have a Summary representing the entire runtime of the application,
-but you want to look at a reasonable time interval. Summary metrics implement a configurable sliding time window.
+but you want to look at a reasonable time interval. This Summary metric implement a configurable sliding time window.
 
 The default is a time window of 10 minutes and 5 age buckets, i.e. the time window is 10 minutes wide, and
-we slide it forward every 2 minutes, but you can configure this values for your own purposes.
+we slide it forward every 10 / 5 = 2 minutes, but you can configure this values for your own purposes.
 
 ```python
 from prometheus_summary import Summary
@@ -75,7 +77,7 @@ from prometheus_summary import Summary
 s = Summary("request_latency_seconds", "Description of summary", ["method", "endpoint"])
 ```
 
-To show request latency by `method`, `endpoint` and `quantile` use next query:
+To show request latency by `method`, `endpoint` and `quantile` use the following PromQL query:
 ```
 max by (method, endpoint, quantile) (request_latency_seconds)
 ```