Глава 23 · Часть II · Планируем SafeSort на GitHub
Глава 23 · Часть II · Планируем SafeSort на GitHubПоля Project: встроенные и пользовательские
Часть полей Project встроена в GitHub, часть можно добавить самим — под конкретный вопрос, который они должны решать.
SafeSort · Часть 2 из 6Планирование
Каждый элемент Project — это набор полей: часть из них встроена в GitHub и есть у любого Project, часть можно добавить самим под конкретную задачу.
Встроенные поля
| Поле | Откуда берётся |
|---|---|
| Title | заголовок Issue или Pull Request |
| Assignees | кому назначена задача в самом Issue |
| Status | колонка Board — управляется Project, не репозиторием |
| Labels | метки Issue/PR из репозитория |
| Repository | какой репозиторий, если Project объединяет несколько |
| Linked pull requests | PR, связанные с Issue через «Closes #N» |
Эти поля Project не придумывает сам — он либо читает их из репозитория (Title, Assignees, Labels), либо управляет ими только внутри себя (Status).
Типы пользовательских полей
| Тип поля | Когда использовать |
|---|---|
| Text | короткая произвольная заметка — например, ссылка на обсуждение |
| Number | числовое значение — например, оценка сложности в часах |
| Date | конкретная дата — например, дедлайн, если он есть |
| Single select | фиксированный список значений — то, что выбирают из выпадающего списка |
| Iteration | повторяющиеся отрезки времени — спринты, недели |
Два пользовательских поля SafeSort
| Поле | Тип | Значения |
|---|---|---|
| Priority | Single select | High / Medium / Low |
| Area | Single select | Packaging / CLI / Filesystem / Safety / Duplicates / Testing / Documentation / CI |
Оба поля — Single select, а не Text: список значений заранее известен и конечен,
а Single select ещё и позволяет группировать и фильтровать Table по значению, чего
свободный текст не даёт. Iteration здесь не нужен — SafeSort
не ведётся спринтами, у задач нет повторяющихся временных отрезков.
Официальная документация
Перевод и учебная адаптация официальной документации GitHub. Исходный материал — CC BY 4.0.
Коротко
- Встроенные поля (Title, Assignees, Status, Labels) есть у любого Project без настройки.
- Пользовательские поля бывают текстом, числом, датой, Single select или Iteration.
- SafeSort использует два поля Single select — Priority и Area — потому что список их значений заранее известен и конечен.