docs: Add github tags widget

content/documentation/admin/external-services.ru.md

@@ -159,6 +159,24 @@ Private-Token: <ваш-gitlab-token>
 
 Подробнее о том, как получить GitLab token можно узнать в [официальной документации](https://docs.gitlab.com/api/rest/authentication/).
 
+### GitHub
+
+**Тип авторизации:** Personal Access Token.
+
+**Заголовки:**
+
+| Заголовок       | Формат значения    |
+|-----------------|--------------------|
+| `Authorization` | `Bearer <токен>`   |
+
+**Пример:**
+
+```sh
+Authorization: Bearer <ваш-github-token>
+```
+
+Токен создаётся в настройках GitHub: «Settings» → «Developer settings» → «Personal access tokens».
+
 ### Harbor
 
 **Тип авторизации:** Basic Authentication.

content/documentation/admin/widgets/types.ru.md

@@ -73,6 +73,44 @@ title: Типы виджетов
 Для выполнения действий с PR требуются соответствующие права доступа в репозитории Bitbucket.
 {{< /alert >}}
 
+## GitHub. Pull Requests
+
+Виджет отображает Pull Requests (PR) репозитория на GitHub и позволяет просматривать изменения, создавать, сливать и закрывать PR.
+
+### Авторизация
+
+Конфигурация авторизации описана в разделе [Внешние сервисы](../external-services/#github).
+В настройках внешнего сервиса или в конфигурации виджета в поле **URL** необходимо указать `https://api.github.com`.
+
+### Конфигурация
+
+| Название             | Обязательность | Описание                                                                                                                                 | Значение по умолчанию |
+|----------------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|
+| Владелец репозитория | **да**         | Владелец репозитория (организация или пользователь). Пример: для `https://github.com/example/my-repo` укажите `example`.                 | —                     |
+| Репозиторий          | **да**         | Название репозитория без `.git`. Пример: для `https://github.com/example/my-repo` укажите `my-repo`.                                     | —                     |
+
+### Статус
+
+В настройках запроса виджета можно фильтровать PR по статусу:
+
+- **Открыт** — только открытые PR (не черновики).
+- **Черновик** — только черновики.
+- **Закрыт** — только закрытые PR.
+- **Все** — любые PR.
+
+По умолчанию отображаются открытые PR. В таблице отображаются: номер, название, описание, статус, метки, автор, дата создания, дата обновления; для каждого PR доступны действия через меню.
+
+### Действия
+
+- **Изменения** — просмотр списка изменённых файлов и диффа по каждому файлу.
+- **Слить** — слияние открытого PR (доступно только для открытых PR, не черновиков).
+- **Закрыть** — закрытие PR без слияния.
+- **Создать PR** — создание нового Pull Request. В диалоге указываются название, исходная ветка, целевая ветка и описание.
+
+{{< alert level="info" >}}
+Для выполнения действий с PR требуются соответствующие права доступа в репозитории GitHub.
+{{< /alert >}}
+
 ## CodeScoring. Зависимости
 
 Виджет позволяет вывести таблицу с зависимостями продукта на основе информации из CodeScoring с указанием названия зависимости, версии, лицензии, количество уязвимостей и другой информацией для каждой зависимости.
@@ -368,6 +406,44 @@ title: Типы виджетов
 | Создать из | **да** | Целевая ветка или тег для запуска пайплайна.                                       | -                     |
 | Описание   | нет     | Описание создаваемого тега.                                                        | -                     |
 
+## GitHub. Теги
+
+Виджет отображает теги репозитория GitHub с информацией о коммите (автор, дата, описание) и позволяет создавать новые теги.
+
+### Авторизация
+
+Конфигурация авторизации описана в разделе [Внешние сервисы](../external-services/#github).
+В настройках внешнего сервиса в поле **URL** необходимо указать `https://api.github.com`.
+
+### Конфигурация
+
+| Название             | Обязательность | Описание                                                                                                                                 | Значение по умолчанию |
+|----------------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|
+| Владелец репозитория | **да**         | Владелец репозитория (организация или пользователь). Пример: для `https://github.com/example/my-repo` укажите `example`.                 | —                     |
+| Репозиторий          | **да**         | Название репозитория без `.git`. Пример: для `https://github.com/example/my-repo` укажите `my-repo`.                                     | —                     |
+
+### Отображаемые данные
+
+В таблице отображаются колонки: тег, описание, автор коммита, ссылка на коммит, дата создания коммита; для каждого тега доступно действие «Просмотр» (просмотр описания коммита).
+
+### Дополнительные возможности виджета
+
+#### Создание тега
+
+Виджет позволяет создавать теги в GitHub. В диалоге «Создать тег» указываются:
+
+| Название      | Обязательность | Описание                                                                                          | Значение по умолчанию |
+|---------------|----------------|---------------------------------------------------------------------------------------------------|-----------------------|
+| Название тега | **да**         | Уникальное название тега, например `v1.0.0` или `release-2024-01`.                                | —                     |
+| Создать из    | **да**         | Ветка или существующий тег, от которого создаётся новый тег.                                      | —                     |
+| Описание      | нет            | Аннотация к тегу (например, описание релиза). Если указано, создаётся аннотированный тег.         | —                     |
+
+Автором аннотированного тега в GitHub отображается пользователь DDP, выполнивший действие.
+
+{{< alert level="info" >}}
+Для создания тегов требуются права на запись в репозиторий GitHub.
+{{< /alert >}}
+
 ## GitLab. Релизы
 
 Виджет отображает список релизов GitLab-проекта, подсвечивает последний релиз и показывает связанную информацию: тег, ссылку на коммит, автора, дату публикации и описание (поддерживает Markdown).

content/documentation/release-notes/v1.4.0.ru.md

@@ -23,10 +23,21 @@ CREATE EXTENSION IF NOT EXISTS pg_trgm;
 
 - **Глобальный поиск** — добавлен поиск по сущностям платформы ([подробнее](../../user/interface/#глобальный-поиск)).
 
+### Виджеты
+
+Добавлены новые виджеты:
+
+- **GitHub. Pull Requests** — для просмотра и управления Pull Requests в GitHub ([подробнее](../../admin/widgets/types/#github-pull-requests)).
+- **GitHub. Теги** — для просмотра и создания тегов в репозитории GitHub ([подробнее](../../admin/widgets/types/#github-теги)).
+
 ### Действия
 
 - **Wait** — добавлено действие для паузы на заданное время ([подробнее](../../admin/actions/types/#wait)).
 
+## Улучшения интерфейса
+
+- Добавлена возможность создания нового виджета непосредственно из окна редактирования дашборда.
+
 ## Исправления
 
 - Исправлена синхронизация источников данных при отсутствующих правилах сопоставления: удаление несуществующих сущностей, обновление параметров или создание связей сущностей теперь запускается только при наличии хотя бы одного правила сопоставления. Создание новых сущностей остается возможным, даже если правила сопоставления не заданы.