Skip to content

Исправлены разорванные команды в примерах - #1153

Open
bontail wants to merge 1 commit into
yandex-cloud:masterfrom
bontail:docs-broken-cli-examples
Open

Исправлены разорванные команды в примерах#1153
bontail wants to merge 1 commit into
yandex-cloud:masterfrom
bontail:docs-broken-cli-examples

Conversation

@bontail

@bontail bontail commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

I hereby agree to the terms of the CLA available at: https://yandex.ru/legal/cla/?lang=ru

Идентификатор платежного аккаунта: dn2ujjv4advyulwqk7mp

Description of changes:

В 57 файлах многострочные команды разорваны. У строки в середине команды нет обратного слеша, поэтому оболочка считает следующую строку отдельной командой, и скопировать такой пример не получится. Всего 103 строки, больше всего в примерах curl перед --data и в командах set-access-bindings с несколькими --access-binding. Добавлен слеш, содержимое команд не менялось.

В 57 файлах примеры многострочных команд нельзя выполнить копированием:
в середине команды у строки пропущен обратный слеш, поэтому оболочка
считает следующую строку отдельной командой и возвращает ошибку.

103 строки, правка везде одна и та же: в конец строки добавлен слеш.
Ничего кроме этого не менялось.

Основные группы:

* 38 строк в примерах curl: после --url пропущен слеш перед --data.
  Больше всего в managed-trino, а также в managed-ytsaurus,
  managed-clickhouse и storedoc. В таком виде запрос уходит без тела;
* 23 строки в примерах назначения ролей: в командах
  set-access-bindings перечисляются несколько --access-binding, и
  слеша нет ни на одной строке, кроме первой. Затронуты compute,
  certificate-manager, dns и другие сервисы;
* остальные случаи разрозненные: yc compute instance
  remove-one-to-one-nat, yc compute ssh, yc organization-manager
  organization list-access-bindings, aws sqs create-queue,
  yc managed-kubernetes cluster create и другие.

Как искал. Разобрал все блоки кода с языком bash, sh и shell, нашел
строки, которые не заканчиваются слешем, притом что следующая строка
начинается с флага и относится к той же команде. Блоки с продолжением
строки по-другому, через обратную кавычку в PowerShell и через ^ в
командной строке Windows, из проверки исключены. Так же исключены
строки, где слеш есть, но за ним идет комментарий: это отдельный
случай, его не трогал.

После правок проверка не находит ни одного разрыва.
@yfm-team

Copy link
Copy Markdown

Все готово!
Commit: 4c90a95
Проверьте результат: RU.
Check the result: EN.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants