Skip to content

Commit

Permalink
Добавляет рецепт «Как создать ишью на GitHub» (#4729)
Browse files Browse the repository at this point in the history
* Добавляет рецепт «Как создать ишью на GitHub»

* Добавляет рецепт в индекс

* Дополняет словарь

* Исправляет тупую ошибку

* Исправляет в тексте неправильную транскрипцию

* Принимает правки @skorobaeus

Co-authored-by: Svetlana Korobtseva <[email protected]>

* Принимает правки @TatianaFokina

Co-authored-by: Tatiana Fokina <[email protected]>

---------

Co-authored-by: Svetlana Korobtseva <[email protected]>
Co-authored-by: Tatiana Fokina <[email protected]>
  • Loading branch information
3 people authored Sep 21, 2023
1 parent 05e6634 commit cd331c7
Show file tree
Hide file tree
Showing 9 changed files with 61 additions and 0 deletions.
2 changes: 2 additions & 0 deletions .yaspeller.json
Original file line number Diff line number Diff line change
Expand Up @@ -553,6 +553,7 @@
"трекать",
"триграфы",
"труъ(шном|)",
"туду",
"тулбар(а|ов|)",
"тулинг(а|)",
"тултип(а|е|ов|ы|у|ом|)",
Expand Down Expand Up @@ -591,6 +592,7 @@
"хардкодим",
"Хелмана",
"хендлеры",
"хештегов",
"Хирагана",
"хиро",
"ховер(у|а|)",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added recipes/github-new-issue/images/issue-labels.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added recipes/github-new-issue/images/issues-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
58 changes: 58 additions & 0 deletions recipes/github-new-issue/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: "Как создать ишью на GitHub"
description: "Если заметили что-то, что нужно изменить в репозитории, создайте ишью."
authors:
- igsekor
related:
- tools/version-control
- tools/git-cli
- tools/github-actions
tags:
- article
---

## Задача

Создать ишью в репозитории на GitHub.

## Решение

Чтобы создать ишью, необходимо проделать последовательно следующие шаги.

Перейти в репозитории на вкладку «Issues» и нажать на кнопку «New issue». Кнопка находится под вкладками на одной строчке с поиском и списком лейблов.

![Список всех ишью репозитория. Нажмите кнопку, чтобы создать новое. Описание выше.](images/issues-list.png)

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

![Редактирование нового ишью. Описание выше.](images/new-issue-editing.png)

Справа в колонке можно назначить исполнителем ишью пользователя репозитория. Для этого раскройте аккордеон «Assignees» c картинкой «колесо настройки» и введите в поле ник нужного пользователя на GitHub. Другой способ — выбрать пользователя из списка рекомендуемых. Обычно в него попадают люди, которые недавно работали с проектом. Если хотели выбрать себя, то сделайте это с помощью ссылки-кнопки «assign yourself». Всего можно назначить 10 пользователей.

![Назначение исполнителя ишью. Описание выше.](images/issue-assignees.png)

К ишью можно добавить метки (labels). Для этого раскройте аккордеон «Labels» c картинкой «колесо настройки». В открывшейся области можно выбрать уже готовые метки, которые используются в проекте. Например, «bug» или «documentation».

Метки — это средства таксономии (что-то вроде хештегов), которые позволяют фильтровать ишью и определять цель и срочность решения.

![Открытый список с доступными метками проекта. Описание выше.](images/issue-labels.png)

После того как полностью сформулировали ишью, нажмите кнопку «Submit new issue», чтобы сохранить его. До того, как вы не завершили работу, кнопка была неактивной.

В репозитории могут храниться шаблоны для ишью. В этом случае при нажатии на кнопку «New issue» откроется страница с выбором шаблона. Например, в Доке есть шаблоны «Сообщить об ошибке», «Предложить идею материала», «Добавить вопрос в рубрику "На собеседовании"» и «Создать новый ишью». Следом за названием и кратким описанием шаблона располагается кнопка «Get started».

![Список шаблонов для ишью. Описание выше.](images/issue-templates.png)

Кнопками «Get started» можно выбрать нужный шаблон. Если ни один шаблон не подходит для вашего случая, можно щёлкнуть по ссылке «Open a blank issue» внизу страницы. Она расположена после списка доступных шаблонов. В любом случае, после нажатия перейдёте на страницу редактирования ишью.

## Разбор решения

Ишью — это правильно сформулированная задача на доработку репозитория. Например, исправление ошибок, внедрение новой функциональности, устранение неудобств при разработке и т. д.

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

Ишью поддерживает [формат Markdown](/tools/markdown/). С его помощью можно создавать туду-листы на основе ненумерованных списков с использованием квадратных скобок в формате `- [x] задача`. Если использовать пробел вместо `x`, то в интерфейсе GitHub такой элемент не будет отмечен галочкой. Галочки можно ставить прямо в интерфейсе. Если ишью содержит туду-листы, то в общем списке они отображаются с кружком. Прогресс выполнения выглядит как заливка другого цвета по форме круга, а рядом подписано сколько задач из общего количества выполнено. Например, «1 of 3 tasks».

![Ишью с туду-листом. Описание выше.](images/issue-item-in-list.png)

Не надо бояться больших номеров ишью. Дело в том, что с точки зрения GitHub, пулреквест — это просто специальное ишью, поэтому номера увеличиваются довольно быстро. Кроме того, ишью, идущие друг за другом, могут иметь номера не по порядку (с пропусками).
1 change: 1 addition & 0 deletions recipes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ groups:
- github-choose-license
- github-add-user-to-repo
- github-new-pull-request
- github-new-issue
- github-add-readme
- name: 'Рутина'
items:
Expand Down

0 comments on commit cd331c7

Please sign in to comment.