Skip to content

Conversation

@sonic16x
Copy link
Contributor

@sonic16x sonic16x commented Oct 27, 2025

Add docs for badges also small refactoring for version component

@sonic16x sonic16x force-pushed the origin/users/rocketraccoon/TESTPLANE-630.badges-docs branch from 89ee0cf to aadb276 Compare October 27, 2025 09:16
@github-actions
Copy link

github-actions bot commented Oct 27, 2025

✅ Successfully deployed static

@sonic16x sonic16x force-pushed the origin/users/rocketraccoon/TESTPLANE-630.badges-docs branch from 16d1532 to 618dd93 Compare October 27, 2025 09:41
<tr><td>[plugins](#plugins)</td><td>`Plugin[]`</td><td>`[]`</td><td>A list of plugins with their settings.</td></tr>
<tr><td>[customScripts](#customscripts)</td><td>`AnyFunction[]`</td><td>`[]`</td><td>A list of functions that implement custom scripts. For example, Yandex.Metrika scripts or a Bug.</td></tr>
<tr><td>[yandexMetrika](#yandexmetrika)</td><td>`YandexMetrika`</td><td>*see below*</td><td>[Yandex.Metrika][yandex-metrika].</td></tr>
<tr><td>[generateBadge](#badgeformatter)</td><td>`BadgeFormatter`</td><td>`null`</td><td>A callback that is called after every test run. It receives the test result and returns a list of badges.</td></tr>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Callback is called "generateBadge", but anchor is still "#badgeformatter"

<tr>
<td>`url`</td>
<td>`string`</td>
<td>Опциональный параметр. Ссылка которая откроется при клике на бейдж.</td>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ссылка которая откроется при клике

Пропущена запятая.

Предлагаю "Ссылка, открываемая при нажатии".


Колбэк, который вызывается после каждого запуска теста. Он получает результат теста и возвращает список бейджей.

Пример использования: здесь мы задаём название тикета и URL, название ветки.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Давай лучше "ключ задачи"


A callback that is called after every test run. It receives the test result and returns a list of badges.

Usage example: here we set the ticket name and URL, the branch name.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lets not use the word "ticket"
In your title and url you use "issue", which is better. Lets use "issue" here instead of "ticket" for consistency


<Version version="11.4.0" />

Колбэк, который вызывается после каждого запуска теста. Он получает результат теста и возвращает список бейджей.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

функция

}
```

Пример как можно установить метаданные в тесте.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Не хватает пунктуации между "Пример" и "как".
Чтобы не думать, что тут конкретно нужно вставить, я бы написал "Пример установки метаданных в тесте"

<tr><td>[plugins](#plugins)</td><td>`Plugin[]`</td><td>`[]`</td><td>Список плагинов с их настройками.</td></tr>
<tr><td>[customScripts](#customscripts)</td><td>`AnyFunction[]`</td><td>`[]`</td><td>Список функций, реализующих кастомные скрипты. Например, скрипты Яндекс.Метрики или Жучка.</td></tr>
<tr><td>[yandexMetrika](#yandexmetrika)</td><td>`YandexMetrika`</td><td>*см. ниже*</td><td>[Яндекс.Метрика][yandex-metrika].</td></tr>
<tr><td>[generateBadge](#badgeformatter)</td><td>`BadgeFormatter`</td><td>`null`</td><td>Колбэк, который вызывается после каждого запуска теста. Он получает результат теста и возвращает список бейджей.</td></tr>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В русской документации не принято использовать слово "колбэк". Лучше "функция"

@sonic16x sonic16x merged commit df78971 into master Oct 29, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants