add bumb2version

docs/yaml.md

@@ -204,6 +204,33 @@ mega:
       {% if m in [0, 1] %}d{% endif %}
 ```
 
+### encoders
+Настройки енкодеров. Енкодер состоит из нескольких портов, поэтому энкодеры настраиваются в отдельном блоке. Настроенный
+енкодер создает в вашем интерфейсе несколько объектов:
+    
+- **light.<encoder_id>**: это rgb-свет, отвечает за светодиод енкодера
+- **sensor.<encoder_id>**: это текущее значение енкодера [0..255]
+
+Пример:
+```yaml
+mega:
+  megaid1:
+    encoders:
+      some_encoder_id: # придумывайте любой
+        int: 6
+        scl: 30
+        sync_to: light.some_light
+```
+
+!!! note ""
+    - **int** (integer): номер порта-прерывания. Если не указать, сервер не будет реагировать на изменения.
+    - **scl** (integer): номер scl-порта, используется для управления подсветкой и синхронизации состояния
+    - **sync_to** (str): entity_id, с которым синхронизирвоать состояние. Синхронизация работает только в
+    одну сторону: а именно, когда вы меняете яркость объекта в интерфейсе, соответсвующая настройка "пробрасывается" на 
+    контроллер. Обычно этого достаточно, тк управление самим светом лучше реализовать штатными средствами контроллера,
+    но в случае, если вы хотите так же управлять яркостью света с помощью енкодера+HA, то нужно использовать автоматизацию,
+    для вашего удобства есть шаблон, который можно установить по кнопке ниже:
+
 ## Параметры интеграции
 ### allow_hosts {: #allow_hosts }
 Отвечает за список хостов, с которых интеграция "слушает" сообщения. По умолчанию, в этот список