작업 목록의 빠른 시작

소개

이 가이드에서는 작업 목록을 사용하여 큰 작업을 여러 작업 목록과 여러 하위 작업으로 분할하는 방법을 보여 줍니다. UI를 사용하여 작업 목록을 만드는 방법, Markdown을 사용하여 작업 목록을 만드는 방법, 작업 목록을 변경하는 방법, 새 작업 목록을 프로젝트와 통합하는 방법을 알아봅니다.

작업 목록을 사용하여 작업을 더 작은 하위 작업으로 나누는 방법을 보여 주기 위해 이 가이드에서는 새 기능에 대한 방문 페이지를 만들어야 하는 시나리오를 따릅니다. 이 가이드를 따라가되, 본인의 실제 시나리오를 반영해 보세요.

필수 조건

이 가이드를 따르는 중에 리포지토리에서 몇 가지 이슈를 만들게 됩니다. 따라서 이슈를 만들 수 있는 리포지토리가 필요합니다.

새 방문 페이지를 추가하는 작업을 추적하는 이슈 만들기

이 단계에서는 부모 이슈를 만들어 새 방문 페이지를 게시하는 데 필요한 하위 작업을 추적합니다.

1. 작업을 추적하려는 리포지토리로 이동합니다.
2. "방문 페이지에 대한 이슈 추적"이라는 제목으로 빈 이슈를 새로 만듭니다. 자세한 내용은 "문제 만들기"을(를) 참조하세요.

첫 번째 작업 목록 만들기

작업 목록은 이슈의 여는 주석(이슈 설명)에 추가됩니다. 이슈에는 제목이 다른 여러 작업 목록이 포함될 수 있습니다. 이는 하위 작업을 분류하는 방법으로 유용합니다.

1. 방금 만든 이슈로 이동합니다. 아직 그렇게 하지 않은 경우 새 이슈 제출을 누릅니다.
2. 이슈 설명의 맨 아래에서 작업 목록 추가를 클릭합니다.

그러면 빈 작업 목록이 이슈에 삽입됩니다.

초안 작업 추가

초안 작업은 작업 목록에 추가되는 텍스트 항목입니다. 초안 작업은 작업 목록에 확인란과 함께 표시됩니다. 초안 작업을 사용하여 프로젝트의 요구 사항 및 하위 작업을 빠르게 살펴보고 필요에 따라 나중에 이슈로 변환할 수 있습니다.

1. 아직 텍스트 필드에 포커스가 없는 경우 작업에 항목 추가를 클릭합니다.

   

2. 이 작업을 보여 주는 몇 가지 초안 작업을 추가합니다. 초안 작업을 입력합니다. 각 작업의 입력을 마칠 때마다 Enter 키를 누릅니다.

   이 예제 방문 페이지 시나리오에서는 다음을 추가할 수 있습니다.

   • “새 방문 페이지 디자인”
   • "방문 페이지의 콘텐츠 만들기"
   • "콘텐츠를 지원되는 언어로 번역"

초안 작업을 이슈로 변환

초안 작업을 이슈로 변환할 수 있습니다. 특정 작업을 시작할 준비가 되면 초안 작업을 변환할 수 있습니다. 이슈는 추적 이슈에 사용한 것과 동일한 리포지토리에 만들어집니다.

1. "새 방문 페이지 디자인" 초안 작업 옆에 있는 를 클릭합니다.

   

2. 메뉴에서 이슈로 변환을 클릭합니다.

새 이슈에 자신을 할당

이제 작업 목록을 종료하지 않고 새 이슈에 자신을 할당할 수 있습니다.

1. 작업 목록의 "새 방문 페이지 디자인" 이슈 옆에 있는 를 클릭합니다.

   

2. 상황에 맞는 메뉴에서 담당자 설정을 클릭합니다.

3. 사용자 목록에서 자신을 선택합니다.

이 상황에 맞는 메뉴를 사용하여 레이블을 설정하고 프로젝트에 이슈를 추가할 수도 있습니다.

작업 목록 이름 바꾸기

추적 중인 작업을 더 잘 나타내도록 작업 목록의 제목을 변경할 수 있습니다. 이는 동일한 이슈에 여러 작업 목록이 있고 작업을 분할하려는 경우에 특히 유용합니다.

1. 작업 목록의 오른쪽 위에서 를 클릭합니다.

   

2. 메뉴에서 이름 바꾸기를 클릭합니다.

3. 작업 목록의 새 제목을 입력하고 Enter 키를 누릅니다.

   이 예제 방문 페이지 시나리오의 경우 이 작업 목록의 이름을 "방문 페이지 콘텐츠"로 바꿀 수 있습니다.

Markdown을 사용하여 두 번째 작업 목록 만들기

단일 이슈에 여러 작업 목록을 만들 수 있습니다. 각 작업 목록에는 고유한 작업과 제목이 있습니다. 이슈를 편집할 때 작업 목록 추가 단추를 사용하거나 Markdown을 입력하여 작업 목록을 추가할 수 있습니다.

1. 이슈 설명(여는 설명)의 맨 위에서 를 클릭합니다.

   

2. 메뉴에서 편집을 클릭합니다.

3. 이슈 설명의 첫 번째 작업 목록 아래에, 아래의 Markdown을 추가합니다.

   Markdown

   ```[tasklist]
   ### Tasks
   - [ ] Draft task
   ```
   

4. 이 작업 목록의 제목을 변경하려면 ### 뒤에 새 제목을 입력합니다. 예를 들어 ### Tasks를 ### Backend changes로 변경합니다.

다음 두 섹션에서는 주석을 저장하기 전에 Markdown을 추가로 변경합니다.

Markdown을 사용하여 초안 작업 추가

Markdown을 사용하여 작업 목록에 직접 입력하여 새 초안 작업을 빠르게 추가할 수 있습니다.

1. 마지막 작업 뒤에 새 줄을 만들고, - [ ] 와 새 작업을 입력합니다. 예들 들어 - [ ] Sign-up form입니다.
2. - [ ] 뒤에 있는 텍스트를 수정하여 기존 초안 작업을 편집합니다. 예를 들어 - [ ] Draft task를 - [ ] Database schema로 변경합니다.

Markdown을 사용하여 기존 이슈 추가

기존 이슈를 작업 목록에 추가하여 추적할 수도 있습니다. Markdown을 사용하거나 이슈 URL을 붙여 넣어 UI에 기존 문제를 추가할 수 있습니다. 액세스 권한이 있는 리포지토리에서 이슈와 끌어오기 요청을 추가할 수 있습니다.

1. 새 줄에 - [ ] 의 입력을 시작한 다음 이슈의 전체 URL을 붙여 넣습니다. 예를 들어 - [ ] https://github.com/octo-org/octo-repo/issues/45
2. 댓글 업데이트를 클릭합니다.

첫 번째 작업 목록 아래에 새로운 두 번째 작업 목록이 표시됩니다.

진행률 추적

작업 목록을 사용하면 추적하도록 선택한 작업의 상태와 진행률을 빠르게 확인할 수 있습니다.

1. 초안 작업 중 하나의 왼쪽에서 확인란을 선택하여 해당 작업을 완료된 것으로 표시합니다.
2. 이전에 초안에서 변환한 이슈를 클릭합니다.
3. 변환된 이슈의 페이지 아래쪽에서 이슈 종결을 클릭합니다.

작업 목록으로 돌아가 페이지를 새로 고치면 방금 종결한 이슈에 종결되었음을 나타내는 아이콘이 표시되는 것을 확인할 수 있습니다. 이슈의 맨 위에 있는 제목 아래에 진행률이 "2/6개 작업"으로 표시됩니다.

프로젝트와 통합

작업 목록에서 빌드하는 관계를 프로젝트에 사용할 수 있습니다. 각 이슈의 진행률을 빠르게 확인하고, 하위 작업을 탐색하고, 작업 목록을 사용하는 보기를 설정할 수 있습니다.

1. 작업 목록 및 이슈에 사용한 것과 동일한 사용자 또는 조직 계정이 소유한 프로젝트로 이동합니다. 아직 사용 가능한 프로젝트가 없는 경우 새 프로젝트를 만들 수 있습니다. 자세한 내용은 "프로젝트 만들기"을(를) 참조하세요.

2. 표 레이아웃을 사용하여 프로젝트에 새 보기를 만듭니다. 보기에 대한 자세한 내용은 "보기 관리"을(를) 참조하세요.

3. 작업 목록의 이슈 중 하나를 프로젝트에 추가합니다. 프로젝트에 항목을 추가하는 방법에 대한 자세한 내용은 "프로젝트에 항목 추가"을(를) 참조하세요.

4. 현재 열려 있는 보기의 이름 옆에 있는 을(를) 클릭합니다.

   

5. 메뉴에서 그룹화 기준, 추적 기준을 차례로 클릭합니다. 이렇게 하면 이슈를 추적하는 이슈를 기준으로 이슈가 그룹화된 보기가 만들어집니다.

이슈와 끌어오기 요청이 작업 목록에 추가되더라도 프로젝트에 자동으로 추가되지는 않습니다. "추적 기준" 필드를 기준으로 보기를 그룹화하면 GitHub에서 작업 목록과 관련된 다른 이슈를 추가하라는 메시지가 표시됩니다.

1. 작업 목록에 프로젝트의 일부가 아닌 이슈가 있는 경우 그룹 아래에 있는 이 프로젝트에 없는 항목 1개를 클릭할 수 있습니다.

1. 이슈 목록에서 추가할 이슈를 클릭합니다. 여러 이슈가 있는 경우 모든 이슈를 추가하도록 선택할 수 있습니다.

결론

이 가이드에서는 두 개의 작업 목록을 사용하여 추적 이슈를 만들고, UI에서 그리고 Markdown을 사용하여 직접 해당 작업 목록을 변경하고, 초안 작업을 이슈로 변환하고, 작업 목록 데이터를 프로젝트와 통합했습니다.

작업 목록의 항목을 관리하는 방법에 대한 자세한 내용은 "작업 목록의 작업 관리"을(를) 참조하세요. 작업 목록을 프로젝트와 통합하는 방법에 대한 자세한 내용은 "프로젝트 및 작업 목록 사용"을(를) 참조하세요.