Docs: Add information about 'WITH' in CREATE GROUP (#13717)

2 files changed, 48 insertions, 6 deletions

diff --git a/ydb/docs/en/core/yql/reference/syntax/create-group.md b/ydb/docs/en/core/yql/reference/syntax/create-group.md
index b0b833e28ce..8a5341fa44f 100644
--- a/ydb/docs/en/core/yql/reference/syntax/create-group.md
+++ b/ydb/docs/en/core/yql/reference/syntax/create-group.md
@@ -1,11 +1,32 @@
 # CREATE GROUP
 
-Creates a group with the specified name.
+Creates a [group](../../../concepts/glossary.md#access-group) with the specified name. Optionally, you can specify a list of [users](../../../concepts/glossary.md#access-user) to add to the group.
 
-Syntax:
+## Syntax
 
 ```yql
-CREATE GROUP group_name
+CREATE GROUP group_name [ WITH USER user_name [ , user_name [ ... ]] [ , ] ]
 ```
 
+### Parameters
+
 * `group_name`: The name of the group. It may contain lowercase Latin letters and digits.
+* `user_name`: The name of the user who will become a member of the group after its creation. It may contain lowercase Latin letters and digits.
+
+## Examples
+
+```yql
+CREATE GROUP group1;
+```
+
+```yql
+CREATE GROUP group2 WITH USER user1;
+```
+
+```yql
+CREATE GROUP group3 WITH USER user1, user2,;
+```
+
+```yql
+CREATE GROUP group4 WITH USER user1, user3, user2;
+```
diff --git a/ydb/docs/ru/core/yql/reference/syntax/create-group.md b/ydb/docs/ru/core/yql/reference/syntax/create-group.md
index 1c12c79c0e5..471164f2235 100644
--- a/ydb/docs/ru/core/yql/reference/syntax/create-group.md
+++ b/ydb/docs/ru/core/yql/reference/syntax/create-group.md
@@ -1,14 +1,35 @@
 # CREATE GROUP
 
-Создает группу с указанным именем.
+Создает [группу](../../../concepts/glossary.md#access-group) с указанным именем. Есть возможность указать список [пользователей](../../../concepts/glossary.md#access-user), входящих в эту группу.
 
-Синтаксис:
+## Синтаксис
 
 ```yql
-CREATE GROUP group_name
+CREATE GROUP group_name [ WITH USER user_name [ , user_name [ ... ]] [ , ] ]
 ```
 
+### Параметры
+
 * `group_name` — имя группы. Может содержать строчные буквы латинского алфавита и цифры.
+* `user_name` — имя пользователя, который станет участником группы после её создания. Может содержать строчные буквы латинского алфавита и цифры.
+
+## Примеры
+
+```yql
+CREATE GROUP group1;
+```
+
+```yql
+CREATE GROUP group2 WITH USER user1;
+```
+
+```yql
+CREATE GROUP group3 WITH USER user1, user2,;
+```
+
+```yql
+CREATE GROUP group4 WITH USER user1, user3, user2;
+```
 
 ## Встроенные группы