Review

doc/monitoring/api_reference.rst

@@ -307,7 +307,8 @@ summary
 Сводка выдаёт также несколько показателей:
 
 - общее число замеров;
-- сумма измеренных значений.
+- сумма измеренных значений;
+- значения по квантилям.
 
 Сводка (summary), как и гистограммы, тоже работает с диапазонами значений. Но в отличие от гистограмм
 использует для этого квантили (quantile, задаются числом от 0 до 1). В этом случае не требуется жёстко
@@ -324,18 +325,19 @@ summary
 - квантиль 0.5 — это значение среднего элемента. В примере у нас чётное число элементов, серединой
   будет пятый = 7. Это значит, что половина замеров у нас даёт разброс значений от 1 до 7.
 
-Обычно в метриках используется один квантиль:
+Стоит отметить, что вычисление квантилей требует ресурсов, поэтому исмеет смысл вычислять не больше одного,
+например:
 
 - 0.95 — большинство замеров
 - и/или 0.99 —  практически все замеры, кроме отдельных случаев, выбросов.
 
 При большом числе замеров в секунду нам понадобится большой массив, чтобы хранить их все. Чтобы
-сэкономить память, массив сжимается. Степень сжатия определяется допустимой ошибкой. Обычно применяют
-степень ошибки колеблется от 1 % до 10 %. Это значит, что квантиль 0.50 с ошибкой 10 % из примера
+сэкономить память, массив сжимается. Степень сжатия определяется допустимой ошибкой. В проектах
+часто встречаются значения от 1 % до 10 %. Это значит, что квантиль 0.50 с ошибкой 10 % из примера
 выше вернёт значение в диапазоне 6,65...7,35, вместо 7.
 
 Кроме того сводка не хранит значения всё время работы приложения. Эта метрика использует скользящее
-окно, поделённое на участки (buckets), в котором хранятся замеры:
+окно, поделённое на участки (buckets), в которых хранятся замеры:
 
 ..  image:: images/summary-buckets.png
     :align: center

doc/monitoring/install.rst

@@ -19,7 +19,7 @@ The usual way
 
         dependencies = {
             ...
-            'metrics == 0.17.0-1',
+            'metrics == 1.0.0',
             ...
         }