Сведения о списках задач

Сведения о списках задач

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

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

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

Сведения об интеграции с projects

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

Создание списков задач с помощью Markdown

Список задач можно создать с помощью Markdown в описании проблемы (начальный комментарий проблемы). Вы можете включить ссылки на проблемы и запросы на вытягивание или создать черновик проблем.

1. Начните создавать новую проблему или изменять описание существующей проблемы.
2. Чтобы начать работу с списком задач, введите ```[tasklist] (тройные обратные знаки и tasklist квадратные скобки) в новой строке в описании проблемы.
3. При необходимости введите ### TITLE в следующей строке, заменив TITLE заголовок списка задач.
4. Для каждого элемента, который вы хотите добавить в список задач, введите - [ ] в новой строке, а затем пробел и ссылку на проблему, ссылку на запрос на вытягивание или текст, чтобы создать черновик проблемы.
   • Необходимо предоставить полную ссылку на проблему или запрос на вытягивание. Например, https://github.com/octo-org/octo-repo/issues/45.
   • Задачи можно форматировать с помощью Markdown.
   • Длина задач не должна превышать 256 символов.
5. Чтобы завершить список задач, введите ``` новую строку после последнего элемента.

Готовый список задач должен выглядеть следующим образом:

```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

Список задач будет отображаться GitHub при сохранении проблемы. Затем можно вносить изменения и добавлять проблемы и черновики с помощью пользовательского интерфейса GitHub. Если вы измените описание проблемы, вы сможете изменить Markdown напрямую или скопировать Markdown, чтобы дублировать список задач в других проблемах.

Вы также можете щелкнуть на панели инструментов форматирования, чтобы вставить список задач при создании новой проблемы или изменении описания проблемы.

Добавление проблем в список задач

1. В нижней части списка задач щелкните Добавить элемент в задачи.

2. Выберите проблему для добавления в список задач.

   • Чтобы добавить недавно обновленную проблему из репозитория, щелкните ее в раскрывающемся списке или выберите ее с помощью клавиш со стрелками и нажмите клавишу ВВОД.
   • Чтобы найти проблему в репозитории, начните вводить название проблемы или номер проблемы и щелкните результат или выберите ее с помощью клавиш со стрелками и нажмите клавишу ВВОД.
   • Чтобы добавить проблему напрямую, используя ее URL-адрес, вставьте URL-адрес проблемы и нажмите клавишу ВВОД.

Создание черновиков проблем в списке задач

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

1. В нижней части списка задач щелкните Добавить элемент в задачи.
2. В поле "Введите, чтобы добавить элемент или вставить URL-адрес проблемы" введите заголовок черновика проблемы и нажмите клавишу ВВОД.

Преобразование черновиков проблем в проблемы в списке задач

Вы можете преобразовать черновик проблем в проблемы. Проблемы создаются в том же репозитории, что и родительская проблема списка задач.

1. Рядом с черновиком проблемы, которую вы хотите преобразовать, щелкните .

   

2. В меню выберите преобразовать в проблему.

Удаление проблемы или черновика проблемы из списка задач

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

1. Рядом с черновиком проблемы, которую вы хотите удалить, выберите .

   

2. В меню щелкните Удалить.

Изменение заголовка списка задач

При создании нового списка задач по умолчанию используется название "Задачи". Вы можете изменить заголовок, изменив markdown проблемы.

1. В правом верхнем углу текста проблемы выберите и нажмите кнопку Изменить.

   

2. В огороженный блок кода, который начинается с ''''[tasklist], add a header with your new title, such as ## My new title'.

   

3. Щелкните Обновить примечание.

Копирование списка задач

При копировании списка задач с помощью параметра "Копировать Markdown" GitHub копирует Markdown в буфер обмена и включает имя проблемы, чтобы можно было вставить список задач за пределами GitHub без потери контекста.

1. В правом верхнем углу списка задач щелкните .

   

2. В меню выберите Копировать markdown.