# GitHub 문제에 대한 빠른 시작

이 간단한 대화형 가이드에 따라 자세한 GitHub Issues내용을 알아보세요.

## 소개

이 가이드에서는 작업 부분을 계획하고 추적하는 데 사용하는 GitHub Issues 방법을 보여 줍니다. 이 가이드에서는 새 문제를 만들고 하위 문제로 세분화합니다. 레이블, 문제 유형, 마일스톤, 담당자 및 프로젝트를 추가하여 문제에 대한 메타데이터를 전달하는 방법도 알아봅니다.

## 필수 조건

문제를 만들려면 리포지토리가 필요합니다. 쓰기 권한이 있는 기존 리포지토리를 사용하거나 새 리포지토리를 만들 수 있습니다.
리포지토리에 활성화된 문제가 있습니다. 리포지토리 만들기에 대한 자세한 내용은 [새 리포지토리 만들기](/ko/enterprise-server@3.22/repositories/creating-and-managing-repositories/creating-a-new-repository)을(를) 참조하세요. 리포지토리에서 이슈 기능이 비활성화되어 있다면, [이슈 사용 안 함](/ko/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues)을 참고하여 활성화하는 방법을 확인하세요.

## 빈 문제 열기

먼저 문제를 만듭니다. 문제를 만드는 방법에는 여러 가지가 있습니다. 워크플로에 가장 편리한 방법을 선택할 수 있습니다. 이 예제에서는 UI를 GitHub 사용합니다. 이슈를 만드는 다른 방법에 대한 자세한 내용은 [문제 만들기](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)을(를) 참조하세요.

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.
2. 리포지토리 이름 아래에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg> Issues**를 클릭합니다.

   ![리포지토리의 기본 페이지 스크린샷. 가로 탐색 모음에서 "문제" 레이블이 지정된 탭이 진한 주황색으로 표시됩니다.](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)
3. **새 문제**를 클릭합니다.
4. 이 예제에서는 빈 문제로 시작합니다. 리포지토리는 문제 템플릿 사용하여 기여자가 특정 정보를 제공하도록 장려할 수 있습니다. 리포지토리에서 문제 템플릿을 사용하는 경우 **빈 문제 열기**를 클릭합니다.

## 정보 입력

문제를 설명하는 제목을 지정합니다. 제목은 문제가 무엇인지 한 눈에 전달해야 합니다.

문제를 해결하는 데 도움이 될 수 있는 세부 정보를 포함하여 문제의 목적을 설명하는 설명을 추가합니다. 예를 들어 버그 보고서인 경우 버그, 예상 결과, 실제 결과를 재현하는 단계를 설명합니다.

markdown을 사용하여 서식, 링크, 이모지 등을 추가할 수 있습니다. 자세한 내용은 [GitHub에 쓰기](/ko/enterprise-server@3.22/get-started/writing-on-github)을(를) 참조하세요.

![제목과 본문이 채워진 새 문제 양식의 스크린샷.](/assets/images/help/issues/issue-title-body.png)

## 작업 목록 추가

또한, 일반 텍스트를 사용하여 해당 문제가 없는 작업을 추적하고 나중에 문제로 변환할 수도 있습니다. 자세한 내용은 [작업 목록 정보](/ko/enterprise-server@3.22/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists)을(를) 참조하세요.

![제목과 본문이 채워진 새 문제 양식의 스크린샷. 본문에 작업 목록의 Markdown이 포함되어 있습니다.](/assets/images/help/issues/issue-task-list-raw.png)

## 문제 배정

책임을 전달하기 위해 조직의 구성원에게 문제를 할당할 수 있습니다.
[다른 GitHub 사용자에게 문제 할당 및 끌어오기 요청](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)을(를) 참조하세요.

![새로운 이슈 작성 양식의 스크린샷. 오른쪽 사이드바의 "담당자" 섹션이 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/issues/issue-assignees.png)

## 레이블 추가

문제를 분류하는 레이블을 추가합니다. 예를 들어, `question` 레이블과 `good first issue` 레이블을 사용하여 이슈가 처음 기여자도 선택할 수 있는 질문임을 나타낼 수 있습니다. 사용자는 레이블별로 문제를 필터링하여 특정 레이블이 있는 모든 문제를 찾을 수 있습니다.

기본 레이블을 사용하거나 새 레이블을 만들 수 있습니다. 자세한 내용은 [레이블 관리](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels)을(를) 참조하세요.

![새로운 이슈 작성 양식의 스크린샷. 오른쪽 사이드바의 "레이블" 섹션이 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/issues/issue-with-label.png)

## 이슈 유형 추가

이슈 유형을 추가하여 조직 전체에서 작업을 분류할 수 있습니다.
[조직에서 이슈 유형 관리](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization)을(를) 참조하세요.

![새로운 이슈 작성 양식의 스크린샷. 오른쪽 사이드바의 "Type" 섹션이 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/issues/issue-type.png)

## 프로젝트에 문제 추가

기존 프로젝트에 문제를 추가하고 프로젝트에 대한 메타데이터를 채울 수 있습니다. 프로젝트에 대한 자세한 내용은 [Projects 정보](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)을(를) 참조하세요.

![새로운 이슈 작성 양식의 스크린샷. 오른쪽 사이드바의 "프로젝트" 섹션이 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/issues/issue-project.png)

## 마일스톤 추가

마일스톤을 추가하여 날짜 기반 대상의 일부로 문제를 추적할 수 있습니다. 마일스톤은 대상 날짜가 다가오면서 문제의 진행률을 표시합니다.
[마일스톤 정보](/ko/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/about-milestones)을(를) 참조하세요.

![새로운 이슈 작성 양식의 스크린샷. 오른쪽 사이드바의 "마일스톤" 섹션이 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/issues/issue-milestone.png)

## 문제 제출

**새 문제 제출**을 클릭하여 문제를 만듭니다. 문제를 만든 후 위의 필드를 편집할 수 있습니다. 문제에는 팀 구성원과 공유하거나 다른 문제 또는 끌어오기 요청에서 참조할 수 있는 고유한 URL이 있습니다.

## 하위 이슈 추가

이슈에 하위 이슈를 추가하여 더 큰 업무를 작은 이슈로 빠르게 나눌 수 있습니다. 하위 문제는 문제 간의 관계를 만들어 GitHub에서 문제의 계층 구조에 대한 지원을 추가합니다. 작업을 자신과 팀에 필요한 세부 정보로 정확하게 분류하여 프로젝트를 정확하게 나타내는 여러 수준의 하위 문제를 만들 수 있습니다.
[AUTOTITLE 및 AUTOTITLE](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)을 참조[하세요](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues).

![이슈 설명 아래의 하위 이슈 섹션 스크린샷. "더 많은 하위 이슈 옵션 보기" 단추가 주황색 사각형으로 강조 표시됩니다.](/assets/images/help/issues/sub-issue-drop-down.png)

## 이슈 종속성 추가

이슈 종속성을 사용하여 이슈 간의 차단 관계를 정의할 수 있습니다. 이슈 종속성을 통해 다른 작업에 의해 차단되었거나 다른 작업을 차단하는 이슈를 식별할 수 있습니다.
[이슈 종속성 만들기](/ko/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies)을(를) 참조하세요.

## 대화

문제가 생성된 후 문제에 주석을 추가하여 대화를 계속합니다. 협력자 또는 팀이 주석에 관심을 갖도록 @mention할 수 있습니다. 동일한 리포지토리에서 관련 문제를 연결하려면 `#`를 입력하고 문제 제목의 일부를 입력한 다음 연결하려는 문제를 클릭할 수 있습니다. 자세한 내용은 [GitHub에 쓰기](/ko/enterprise-server@3.22/get-started/writing-on-github)을(를) 참조하세요.

![이슈 주석의 스크린샷. 머리글은 "Octocat이 지금 댓글을 달았습니다"라고 되어 있으며, 본문은 "@hubot 로켓 로직을 업데이트해야 합니까?"라고 되어 있습니다.](/assets/images/help/issues/issue-comment.png)

## 다음 단계

다양한 용도로 문제를 사용할 수 있습니다. 예시:

* 아이디어 추적
* 피드백 수집
* 작업 계획
* 버그 보고

문제를 보다 관리하기 쉬운 작업으로 세분화하려면 여러 수준의 하위 문제를 추가하면 됩니다.
[하위 이슈 추가](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)을(를) 참조하세요.

다음 단계를 수행하는 GitHub Issues데 유용한 리소스는 다음과 같습니다.

* 이슈에 대한 자세한 내용은 [문제 개요](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)을(를) 참조하세요.
* '의 계획 및 추적 도구를 사용하기 GitHub위한 필수 사항에 대해 알아보려면 [팀 또는 프로젝트에 대한 작업 계획 및 추적](/ko/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project)을 참조하세요.
* 프로젝트가 계획 및 추적에 도움이 되는 방법에 대한 자세한 내용은 [Projects에 대해 알아보기](/ko/enterprise-server@3.22/issues/planning-and-tracking-with-projects/learning-about-projects)을(를) 참조하세요.
* 문제 템플릿 사용하여 참가자가 특정 정보를 제공하도록 권장하는 방법에 대한 자세한 내용은 [템플릿을 사용하여 유용한 이슈 및 끌어오기 요청 권장](/ko/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests)을 참조하세요.