From 5b268891db85c8b80a02945d1b67cb531e1dd714 Mon Sep 17 00:00:00 2001
From: Durable Workflow <support@durable-workflow.com>
Date: Wed, 7 Oct 2026 16:47:01 +0000
Subject: [PATCH] Select Waterline 2.3.0 and document Ukrainian interface
 configuration

---
 docs/waterline-operator-api.md                  | 16 ++++++++++++++++
 .../current/waterline-operator-api.md           | 17 +++++++++++++++++
 static/stable-releases.json                     |  2 +-
 3 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/docs/waterline-operator-api.md b/docs/waterline-operator-api.md
index 1506b4a8dac..b182e06a275 100644
--- a/docs/waterline-operator-api.md
+++ b/docs/waterline-operator-api.md
@@ -51,6 +51,22 @@ php artisan waterline:publish
 For the self-contained service image and its connection, authentication, and
 persistence inputs, use [Monitoring](./monitoring.md#waterline-service).
 
+### Interface Language
+
+Waterline 2.3.0 supports English and Ukrainian in both embedded and service
+mode. Select Ukrainian in the Laravel application's environment or the service
+container's environment:
+
+```dotenv
+WATERLINE_LOCALE=uk
+```
+
+English (`en`) is the default and fallback. Embedded applications can also set
+`waterline.locale` in their resolved configuration. Rebuild a cached Laravel
+configuration after changing the setting. Waterline keeps the host application's
+locale, workflow names, identifiers, payloads and original exception text
+unchanged. JSON API field names and machine states retain their existing values.
+
 ## Deployment Boundary
 
 Waterline has two backend adapters:
diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/waterline-operator-api.md b/i18n/uk/docusaurus-plugin-content-docs/current/waterline-operator-api.md
index 11d9e1163c2..30e8fede0ec 100644
--- a/i18n/uk/docusaurus-plugin-content-docs/current/waterline-operator-api.md
+++ b/i18n/uk/docusaurus-plugin-content-docs/current/waterline-operator-api.md
@@ -53,6 +53,23 @@ php artisan waterline:publish
 автентифікації й зберігання описано в
 [моніторингу](./monitoring.md#waterline-service).
 
+### Мова інтерфейсу {#interface-language}
+
+Waterline 2.3.0 підтримує українську та англійську мови у вбудованому режимі
+та режимі окремого сервісу. Щоб вибрати українську, задайте змінну середовища
+Laravel-застосунку або контейнера сервісу:
+
+```dotenv
+WATERLINE_LOCALE=uk
+```
+
+Англійська (`en`) є типовою мовою та використовується для відсутніх перекладів.
+Вбудований застосунок також може задати `waterline.locale` у своїй конфігурації.
+Після зміни налаштування оновіть кеш конфігурації Laravel, якщо він увімкнений.
+Waterline зберігає мову основного застосунку, назви робочих процесів,
+ідентифікатори, дані та оригінальні тексти винятків. Назви полів JSON API
+та машинні значення станів залишаються незмінними.
+
 ## Межа розгортання {#deployment-boundary}
 
 Waterline має два backend adapters:
diff --git a/static/stable-releases.json b/static/stable-releases.json
index 13fc05a5516..112abbfcf45 100644
--- a/static/stable-releases.json
+++ b/static/stable-releases.json
@@ -8,7 +8,7 @@
     "sdk-python": "2.4.2",
     "sdk-rust": "3.2.0",
     "server": "2.5.9",
-    "waterline": "2.2.0",
+    "waterline": "2.3.0",
     "workflow": "2.5.3"
   }
 }