Навигация
Задачи
Создание задач, Kanban-доски, шаблоны, метки, вехи и автоматизация в GitRiver
Задачи (Issues) - основной инструмент для отслеживания работы: баг-репорты, фичи, обсуждения. Каждая задача привязана к репозиторию и может содержать описание, метки, вехи, ответственных и чеклисты.
Создание задачи
- Откройте вкладку Задачи в репозитории
- Нажмите «Новая задача»
- Заполните:
- Заголовок - краткое описание (обязательно)
- Описание - подробности в Markdown (необязательно)
- Ответственный - кто будет выполнять
- Метки - категоризация (баг, фича, документация)
- Веха - к какому этапу/релизу относится
- Проект - на какой Kanban-доске отображать
- Нажмите «Создать»
Ссылки на задачи
В описаниях и комментариях можно ссылаться на другие задачи:
#42- ссылка на задачу в текущем репозиторииgroup/repo#42- ссылка на задачу в другом репозиторииЗакрывает #42илиFixes #42в описании пулл-реквеста - задача автоматически закроется при слиянии
Чеклисты
Внутри описания задачи можно создать чеклист:
- [ ] Написать тесты
- [ ] Обновить документацию
- [x] Исправить баг
Прогресс чеклиста отображается в списке задач.
Шаблоны задач
Чтобы пользователи создавали задачи в едином формате, добавьте шаблоны.
Создание шаблонов
Создайте файлы в директории .gitriver/templates/issue/ репозитория:
<!-- .gitriver/templates/issue/bug-report.md -->
---
name: Баг-репорт
about: Сообщить об ошибке
labels: ["bug"]
---
## Описание бага
Кратко опишите проблему.
## Шаги для воспроизведения
1. Перейдите на ...
2. Нажмите ...
3. Увидите ...
## Ожидаемое поведение
Что должно было произойти.
## Фактическое поведение
Что произошло на самом деле.
## Окружение
- Версия GitRiver:
- Браузер:
- ОС:
<!-- .gitriver/templates/issue/feature-request.md -->
---
name: Запрос фичи
about: Предложить новую функциональность
labels: ["enhancement"]
---
## Описание
Что вы хотите добавить?
## Зачем это нужно
Какую проблему это решает?
## Возможная реализация
Как это может работать (опционально).
При создании задачи пользователь видит список шаблонов и выбирает подходящий.
Метки
Метки - цветные теги для категоризации задач.
Встроенные метки
При создании репозитория автоматически создаются метки:
| Метка | Цвет | Назначение |
|---|---|---|
bug | красный | Ошибка |
enhancement | синий | Улучшение |
documentation | зелёный | Документация |
question | жёлтый | Вопрос |
duplicate | серый | Дубликат |
wontfix | серый | Не будет исправлено |
good first issue | фиолетовый | Для новичков |
Управление метками
Настройки репозитория -> Метки:
- Создание новых (название, цвет, описание)
- Редактирование существующих
- Удаление (метка снимется со всех задач)
Фильтрация
В списке задач используйте фильтры:
- По одной или нескольким меткам
- По ответственному
- По автору
- По вехе
- По состоянию (открытые / закрытые)
- Свободный текстовый поиск
Вехи
Вехи (Milestones) группируют задачи по этапам или релизам.
Создание вехи
- Откройте вкладку Вехи в репозитории
- Нажмите «Новая веха»
- Укажите:
- Название (например,
v1.2.0) - Описание - что входит в этот этап
- Дата дедлайна (опционально)
- Название (например,
Прогресс
Каждая веха показывает:
- Прогресс-бар - процент закрытых задач
- Количество открытых / закрытых задач
- Дней до дедлайна (если указан)
Привязка задач
При создании или редактировании задачи выберите веху в выпадающем списке. Одна задача может быть привязана только к одной вехе.
Kanban-доски (Проекты)
Визуальное управление задачами через Kanban-доски.
Создание проекта
- Откройте вкладку Проекты в репозитории (или группе)
- Нажмите «Новый проект»
- Укажите название и описание
- Проект создаётся с тремя колонками по умолчанию:
- К выполнению (To Do)
- В работе (In Progress)
- Готово (Done)
Настройка колонок
- Добавляйте новые колонки (например: «На ревью», «Тестирование»)
- Переименовывайте существующие
- Меняйте порядок перетаскиванием
- Удаляйте пустые колонки
Работа с карточками
- Перетаскивание - перемещайте задачи между колонками
- Привязка задач - нажмите «+» в колонке и выберите задачу
- Автоматическое перемещение - задача перемещается в «Готово» при закрытии
- Фильтрация - по меткам, ответственным, приоритету
Проекты на уровне группы
Проект можно создать для всей группы - тогда в него можно добавлять задачи из любых репозиториев группы. Удобно для кросс-командных инициатив.
Комментарии
Форматирование
Комментарии поддерживают полный Markdown:
- Текст, списки, таблицы
- Подсветка синтаксиса кода
- Изображения (drag & drop или вставка из буфера)
- Математические формулы (KaTeX)
- Диаграммы (Mermaid)
Упоминания
@username- упомянуть пользователя (получит уведомление)@group/team- упомянуть команду#42- ссылка на задачу
Реакции
Добавляйте реакции (эмодзи) к комментариям вместо +1 комментариев.
Редактирование и удаление
Автор комментария и администратор могут редактировать и удалять комментарии. История редактирования сохраняется.
Автоматизация
Автозакрытие задач
Если в описании или коммите пулл-реквеста указать ключевые слова:
Закрывает #42
Fixes #42
Resolves #42
Close #42
Задача закроется автоматически при слиянии пулл-реквеста.
Уведомления
Участники задачи (автор, ответственный, подписчики) получают уведомления:
- Новый комментарий
- Изменение статуса
- Назначение ответственного
- Упоминание через @
Каналы уведомлений настраиваются в профиле пользователя.