-
Notifications
You must be signed in to change notification settings - Fork 635
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Добавляет рецепт «Как создать ишью на GitHub» (#4729)
* Добавляет рецепт «Как создать ишью на 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
1 parent
05e6634
commit cd331c7
Showing
9 changed files
with
61 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
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.
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.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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, пулреквест — это просто специальное ишью, поэтому номера увеличиваются довольно быстро. Кроме того, ишью, идущие друг за другом, могут иметь номера не по порядку (с пропусками). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters