Перейти к содержанию
ERITKOM
ВебНовость

GitHub открыл типы и поля Issues для личных аккаунтов

Структурированные метаданные задач стали общедоступны в личных репозиториях. Настройки принадлежат владельцу, а их использование в Projects ограничено принадлежностью задач и видимостью полей.

Архивное фото физической канбан-доски с карточками задач; не интерфейс GitHub
Архивное фото канбан-доски, 4 марта 2020 года: Marcos Costa Junior / Wikimedia Commons, CC BY-SA 4.0. Не скриншот GitHub. Изменены размер и формат; производная иллюстрация распространяется по CC BY-SA 4.0.

Возможности организаций появились у личных владельцев

GitHub 11 ноября объявил об общей доступности типов и полей Issues в репозиториях, принадлежащих личным аккаунтам. Это уже не предварительный доступ. Управление находится в настройках аккаунта, в разделе Planning. Пользователь может создать до 25 типов и до 25 полей, чтобы описывать задачи одинаковым способом в собственных репозиториях.

Вместо необходимости выражать каждое свойство меткой появляется отдельная структура: тип задачи, приоритет, трудоёмкость или дата. Изменять такие данные можно при создании и просмотре Issue, а также массово через Projects. Для автоматизации предусмотрены REST API, GraphQL и вебхуки. Объявление относится именно к персональному владению репозиториями: оно не превращает частные настройки одного аккаунта в общий справочник для всех участников GitHub.

Тип определяет характер работы

По умолчанию доступны Bug, Task и Feature, но владелец может изменить их названия, описания и цвета, отключить ненужные или добавить свои. Типы задаются на уровне владельца, а затем применяются в принадлежащих ему репозиториях. Это позволяет отличать исправление ошибки от новой возможности без раздельного ведения одинаковых классификаторов в каждом проекте.

Тип отображается рядом с задачей и может использоваться в поиске и представлениях Projects. При этом отключение и удаление имеют разные последствия. Отключённый тип нельзя назначать заново, и он перестаёт отображаться; после повторного включения связь с прежними задачами восстанавливается. Удаление же окончательно убирает тип. Такая разница существенна, когда команда пересматривает классификацию, но хочет сохранить возможность вернуться к прежней схеме.

Полям нужны правила видимости

Поля хранят конкретные значения: документация описывает текст, число, дату и выбор одного варианта. В стандартном наборе есть Priority, Effort, Start date и Target date. Владелец может настроить состав и закрепить нужные поля для определённого типа задач либо для задач без типа. Пустые незакреплённые поля не занимают постоянное место в карточке.

Для публичных репозиториев важна отдельная настройка видимости. По умолчанию поле имеет режим Restricted: в личном репозитории его видят владелец и приглашённые участники с доступом не ниже чтения. Режим Public открывает данные всем. Ограничения действуют не только в интерфейсе, но и через API. Удаление поля уничтожает его значения в задачах; создание одноимённого поля не возвращает потерянные данные.

Текстовое поле также распознаёт ссылки, а числовое допускает дробные значения. Это позволяет хранить оценку работы отдельно от описания задачи, не превращая её в произвольную строку.

Projects использует данные с ограничениями

Поле Issue можно вывести столбцом таблицы Projects, редактировать его значение и использовать для сортировки, фильтрации, группировки или диаграмм. Изменение синхронизируется с самой задачей: это не независимая копия свойства внутри одной доски. Если поле убрать из проекта, определение и значения на задачах сохраняются, и столбец можно добавить снова.

Однако поля работают только для Issues, принадлежащих тому же пользователю или организации, что и проект. Для задач другого владельца, черновых задач и pull requests соответствующие ячейки остаются пустыми. В публичных и внутренних проектах доступны лишь поля с публичной видимостью. Кроме того, проект ограничен 50 полями в сумме, включая системные и поля Issues. Лимит аккаунта в 25 полей не отменяет этого отдельного ограничения.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача