Issue artifacts сохраняют рядом с задачей документы, ссылки и интерактивные схемы. Файл можно обновить без потери истории версий.
План исправления часто остаётся в одном комментарии, ссылка на обсуждение — в другом, а диаграмма устаревает после первой правки. В предварительной версии GitHub Issues появился отдельный список материалов задачи. Markdown подходит для плана или разбора причины сбоя; ссылкой можно прикрепить обсуждение; HTML-файл позволяет переключаться между готовой визуализацией и её исходным текстом.
Как поддерживать план в актуальном состоянии
На github.com материал можно редактировать прямо в задаче с сохранением истории. У него есть собственная ссылка, так что команде не приходится каждый раз пересылать новую копию. В командной строке эти действия собраны в группе gh issue artifact: можно перечислить вложения, открыть нужное и загрузить файл. HTML уже просматривается на сайте; поддержка HTML в приложении GitHub была анонсирована отдельно.