diff --git a/README.md b/README.md
index 2495d68d..299169bc 100644
--- a/README.md
+++ b/README.md
@@ -33,15 +33,15 @@ poetry granian --no-ws --host 0.0.0.0 --port 8080 --interface asgi main:app
 ```
 ## Подключенные сервисы
 
-Для межсерверной коммуникации используется разны механики, похожим образом это устроено в других сервисах нашей инфраструктуры.
+Для межсерверной коммуникации используется разные механики, похожим образом это устроено в других сервисах нашей инфраструктуры.
 
 ### auth.py
 
-Настройте переменную окружения WEBHOOK_SECRET и настройте webhook-полезную нагрузку на /new-author. Он ожидается при создании нового пользователя. На фронтенде включите заголовок Authorization с токеном из запроса signIn или мутации registerUser.
+Задайте переменную окружения `WEBHOOK_SECRET` чтобы принимать запросы по адресу `/new-author` от (сервера авторизации)[https://dev.discours.io/devstack/authorizer]. Событие ожидается при создании нового пользователя. Для авторизованных запросов и мутаций фронтенд добавляет к запросу токен авторизации в заголовок `Authorization`.
 
 ### viewed.py
 
-Для статистики просмотров установите переменные окружения GOOGLE_ANALYTICS_TOKEN и GOOGLE_GA_VIEW_ID для сбора данных из Google Analytics.
+Задайте переменные окружения `GOOGLE_ANALYTICS_TOKEN` и `GOOGLE_GA_VIEW_ID` для сбора данных из Google Analytics.
 
 ### search.py
 
@@ -49,7 +49,7 @@ poetry granian --no-ws --host 0.0.0.0 --port 8080 --interface asgi main:app
 
 ### notify.py
 
-Отправка уведомлений по Redis PubSub каналам
+Отправка уведомлений по Redis PubSub каналам, согласно структуре данных, за которую отвечает [сервис уведомлений](https://dev.discours.io/discours.io/notifier)
 
 ###  unread.py