diff --git a/docs/IMPLEMENTATION_SPEC.md b/docs/IMPLEMENTATION_SPEC.md
index c30b04c..2af96a4 100644
--- a/docs/IMPLEMENTATION_SPEC.md
+++ b/docs/IMPLEMENTATION_SPEC.md
@@ -101,7 +101,7 @@ awg2-harness validate-runtime
 
 - управляет только sysctl-параметрами хоста;
 - пишет `/etc/sysctl.d/90-awg2-harness-vpn.conf`;
-- дополнительно пишет `/etc/modules-load.d/90-awg2-harness-bbr.conf`, но только когда BBR фактически активен; если BBR неактивен, этот файл удаляется;
+- дополнительно пишет `/etc/modules-load.d/90-awg2-harness-bbr.conf`, но только когда BBR выбран desired policy (`auto`/`require` и BBR доступен); иначе этот файл удаляется;
 - применяет runtime-изменения точечно (`sysctl -w`) и только для drifted keys;
 - не использует `/etc/sysctl.conf` и `sysctl --system`;
 - не управляет `udp_wmem_min`.
diff --git a/docs/UPSTREAM_COMPATIBILITY.md b/docs/UPSTREAM_COMPATIBILITY.md
index f83c960..daceed1 100644
--- a/docs/UPSTREAM_COMPATIBILITY.md
+++ b/docs/UPSTREAM_COMPATIBILITY.md
@@ -21,7 +21,7 @@ AWG 3.0 и 2.x остаются regression compatibility. Контейнер `am
 
 | Компонент | Версия или ревизия | Назначение |
 |---|---|---|
-| AmneziaVPN | `5.0.1.5`, tag `7d4f3e0f5090b74903609179653d1f669d2ad08a` | Self-hosted deployment AWG 3.1 и container contract |
+| AmneziaVPN | `5.0.1.5`, commit `7d4f3e0f5090b74903609179653d1f669d2ad08a` | Self-hosted deployment AWG 3.1 и container contract |
 | `amneziawg-tools` | `v3.1.20260812`, commit `ee0f0a9aa34ff0a0da4b3433b9512781cfe02843` | CLI, `awg-quick`, формат `show all dump` |
 | `amneziawg-go` | `v3.1.20260814`, commit `1b86b2ae0e493e7ea93f8c1a0f0cb6735b1551f1` | userspace fallback и reference container image |