add read without consumer docs (#15883)

Co-authored-by: lopatinevgeny <[email protected]>

Часть общих замечаний решили вынести в отдельный тикет: LOGBROKER-9563
Текущий текст, считаю норм. 
Также стоит поднять вопрос почему формат выдачи (--format) определяет алгоритм работы (--wait) - очень странное решение. Это не к документации вопрос уже, а к алгоритму работы системы. Я бы изменил поведение - алгоритм работы первичен, если какой-то формат в этом режиме не поддерживается, то должна быть ошибка при запуске команды.

Author: a-serebryanskiy

ydb/docs/en/core/reference/ydb-cli/topic-read.md

@@ -21,13 +21,16 @@ Three command modes are supported:
 
 ### Required parameters
 
-| Name | Description |
----|---
-| `<topic-path>` | Topic path |
-| `-c VAL`, `--consumer VAL` | Topic consumer name.<br/>Message consumption starts from the current offset for this consumer (if the `--timestamp` parameter is not specified).<br/>The current offset is shifted as messages are consumed and output (if `--commit=false` is not set). |
+`<topic-path>`: Topic path
 
 ### Basic optional parameters
 
+`-c VAL`, `--consumer VAL`: Topic consumer name.
+
+- If not set, then you need to specify partitions through --partition-ids to read without consumer
+- Message consumption starts from the current offset for this consumer (if the `--timestamp` parameter is not specified).
+If consumer name is not specified, message consumption will start from the first message in partition.
+
 `--format STR`: Output format.
 
 - Specifies how to format messages at the output. Some formats don't support streaming mode.
@@ -63,10 +66,11 @@ Three command modes are supported:
 
 `--file VAL` (`-f VAL`): Write the messages read to the specified file. If not set, messages are output to `stdout`.
 
-`--commit BOOL`: Commit message reads.
+`--commit BOOL`: Commit message reads. Default value - `false`.
 
-1. If `true` (by default), a consumer's current offset is shifted as topic messages are consumed.
-2. Possible values: `true` or `false`.
+- Possible values: `true` or `false`.
+- If `true`, a consumer's current offset is shifted as topic messages are consumed.
+- If the value is set to `false`, messages will be read, but the reading progress won't be saved, and upon restart, the messages will be read again. This functionality is useful for debugging: allowing messages to be read without affecting the production system (without offset commit).
 
 ### Other optional parameters
 

ydb/docs/ru/core/reference/ydb-cli/topic-read.md

@@ -3,7 +3,7 @@
 Командой `topic read` выполняется чтение сообщений из топика с выводом их в файл или в терминал командной строки:
 
 ```bash
-{{ ydb-cli }} [connection options] topic read <topic-path> --consumer STR \
+{{ ydb-cli }} [connection options] topic read <topic-path> [--consumer STR] \
   [--format STR] [--wait] [--limit INT] \
   [--transform STR] [--file STR] [--commit BOOL] \
   [дополнительные параметры...]
@@ -21,13 +21,16 @@
 
 ### Обязательные параметры
 
-Имя | Описание
----|---
-`<topic-path>` | Путь топика
-`-c VAL`, `--consumer VAL` | Имя читателя топика.<br/>Чтение сообщений будет начато с текущей рабочей позиции (offset) для данного читателя (если не указан параметр `--timestamp`).<br/>Текущая рабочая позиция будет передвигаться по мере чтения и вывода сообщений (если не указано значение параметра `--commit=false`).
+`<topic-path>`: Путь топика
 
 ### Основные опциональные параметры
 
+`-c VAL`, `--consumer VAL`: Имя читателя топика.
+
+- Если имя читателя не задано, то необходимо указать значение параметра `--partition-ids`. Только в этом случае возможно чтение из топика без указания имени читателя.
+- Чтение сообщений будет начато с текущей рабочей позиции (offset)
+для данного читателя (если не указан параметр `--timestamp`). Если не указать имя читателя, то чтение сообщений начнется с первого сообщения в партиции
+
 `--format STR`: Формат вывода
 
 - Задает правило оформления сообщений на выходе. Не все форматы могут работать в потоковом режиме.
@@ -63,10 +66,11 @@
 
 `--file VAL` (`-f VAL`): Записывать читаемые сообщения в указанный файл. Если параметр не задан, то сообщения выводятся в `stdout`.
 
-`--commit BOOL`: Подтверждение чтения.
+`--commit BOOL`: Подтверждение чтения. Значение по умолчанию - `false`
 
-1. Если установлено значение `true` (по умолчанию), то текущая рабочая позиция (offset) читателя в топике будет передвигаться по мере чтения сообщений из топика.
-2. Возможные значения: `true`, `false`.
+- Возможные значения: `true`, `false`.
+- Если установлено значение `true`, то текущая рабочая позиция (offset) читателя в топике будет сохраняться по мере чтения сообщений из топика.
+- Если установлено значение `false`, то сообщения будут вычитываться, но прогресс чтения не будет сохраняться и при перезапуске сообщения будут вычитаны заново. Эта функциональность полезна при дебаге: для вычитывания сообщений без влияния на продуктовую систему (без смещение offset).
 
 ### Другие опциональные параметры