GitHub는 협업 플랫폼임
GitHub가 수행하는 모든 작업의 중심에는 협업이 있습니다. 모듈의 첫 번째 단원에서 리포지토리를 알아보고 리포지토리가 프로젝트 및 해당 파일을 구성하는 데 도움이 된다는 것을 배웠습니다. 지난 단원에서는 프로젝트의 변경 내용을 추적하는 방법인 끌어오기 요청에 대해 알아보았습니다.
이 단원에서는 문제와 토론에 대해 알아봅니다. GitHub Enterprise Platform의 공동 작업 특성에 기여하는 기능입니다.
문제
GitHub 문제는 GitHub에서 작업에 대한 아이디어, 피드백, 작업 또는 버그를 추적하는 데 사용됩니다. 다양한 방법으로 이슈를 만들 수 있으므로 워크플로에 가장 편리한 방법을 선택하면 됩니다.
이 연습에서는 리포지토리에서 문제를 만드는 방법을 설명합니다. 다음에서 문제를 만들 수도 있습니다.
- 작업 목록의 항목.
- 프로젝트의 메모.
- 문제 또는 끌어오기 요청의 설명.
- 특정 코드 줄.
- URL 쿼리.
리포지토리에서 이슈 만들기
GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.
리포지토리 이름 아래에서 문제를 선택합니다.
새 문제를 선택합니다.
리포지토리에서 문제 템플릿을 사용하는 경우 열려는 문제 유형 옆에 있는 시작 선택을 선택합니다.
열려는 문제 유형이 사용 가능한 옵션에 포함되지 않은 경우 빈 문제 열기를 선택합니다. 템플릿을 사용하지 않는 경우 5단계로 건너뜁니다.
리포지토리에서 문제 양식을 사용하는 경우 빈 문제 템플릿 대신 작성할 구조적 양식이 표시됩니다. 문제 양식을 사용하면 유지 관리자가 표준화된 형식으로 특정 정보를 수집할 수 있습니다.
제목 추가 필드에 문제에 대한 제목을 입력합니다.
설명 추가 필드에 문제에 대한 설명을 입력합니다.
프로젝트 유지 관리자인 경우 문제를 다른 사람에게 할당하거나, 프로젝트 보드에 추가하거나, 마일스톤과 연결하거나, 레이블을 적용할 수 있습니다.
완료되면 새 문제 제출을 선택합니다.
레이블, 멘션 및 반응을 사용하여 공동 작업을 효과적으로 관리하고 문제 가시성을 높입니다. 문제 템플릿은 참가자에 대한 일관된 구조와 기대치를 유지하는 데 도움이 됩니다.
일부 대화는 GitHub 토론에 더 적합할 수 있습니다. GitHub 토론을 사용하여 질문 및 답변, 정보 공유, 발표, 프로젝트 대화 수행 또는 참여
다음 섹션에서는 토론과 기능을 가장 잘 활용하는 방법을 검토합니다.
토론
토론은 Q&A, 아이디어 또는 일반적인 피드백과 같이 코드에 반드시 연결되지 않는 대화를 위해 설계되었습니다. 공유 포럼 내에서 개방적이고 지속적인 통신을 지원하며 리포지토리의 가시성에 따라 공개 또는 비공개일 수 있습니다.
이 섹션에서는 다음을 수행하는 방법을 배우게 됩니다.
- 리포지토리에서 토론 사용.
- 새 토론 및 다양한 토론 범주 만들기.
리포지토리에서 토론을 사용하도록 설정하는 방법에 대해 자세히 살펴보겠습니다.
리포지토리에서 토론 사용
리포지토리 소유자 및 쓰기 액세스 권한이 있는 사용자는 퍼블릭 및 프라이빗 리포지토리에서 커뮤니티에 대한 GitHub 토론을 사용하도록 설정할 수 있습니다. 토론의 표시 유형은 만든 리포지토리에서 가시성을 상속합니다.
GitHub 토론을 처음 사용하도록 설정하면 환영 게시물을 구성하라는 메시지가 표시됩니다.
GitHub.com에서 리포지토리의 기본 페이지로 이동합니다.
리포지토리 이름 아래에서 설정을 선택합니다.
기능 섹션까지 아래로 스크롤하고 토론 아래에서 토론 설정을 선택합니다.
새 토론 시작 아래에서 커뮤니티의 어조 및 리소스에 맞게 템플릿을 편집합니다.
토론 시작을 선택합니다.
이제 새 토론을 만들 준비가 되었습니다.
새 토론 만들기
리포지토리를 볼 수 있는 인증된 사용자는 해당 리포지토리에서 토론을 만들 수 있습니다. 조직 수준 토론의 경우 원본 리포지토리를 볼 수 있는 모든 사용자가 토론을 만들 수도 있습니다.
GitHub.com에서 토론을 시작하려는 리포지토리 또는 조직의 기본 페이지로 이동합니다.
리포지토리 또는 조직 이름 아래에서 토론을 선택합니다.
페이지 오른쪽에서 새 토론을 선택합니다.
시작 항목을 선택하여 토론 범주를 선택합니다. 모든 토론은 범주에 배치되어야 합니다. 리포지토리 유지 관리자가 이러한 범주를 정의합니다.
각 토론 범주에는 용도를 명확히 하기 위한 고유한 이름, 이모지 및 설명이 포함됩니다. 범주는 대화 내용을 정리하는 데 도움이 됩니다. Q&A나 보다 개방적인 대화와 같은 범주를 구분하는 데 도움이 되도록 사용자 지정이 가능합니다. 다음 표에서는 토론 및 해당 용도에 대한 기본 범주를 보여 줍니다.
| 범주 | 목적 | 형식 |
|---|---|---|
| 📣 알림 | 프로젝트 유지 관리자가 제공하는 업데이트 및 뉴스 | 알림 |
| #️⃣ 일반 | 프로젝트와 관련된 모든 내용 | 개방형 토론 |
| 💡 아이디어 | 프로젝트를 변경하거나 개선하는 아이디어 | 개방형 토론 |
| 🗳️ 설문 조사 | 커뮤니티가 투표하고 토론할 수 있는 여러 옵션이 있는 설문 조사 | 설문 조사 |
| 🙏 질의응답 | 커뮤니티가 질문/답변 형식으로 답변할 수 있는 질문 | 질문 및 답변 |
| 🙌 표시 및 말하기 | 프로젝트와 관련된 생성, 실험 또는 테스트 | 개방형 토론 |
리포지토리 유지 관리자는 더 나은 가시성을 위해 토론 탭의 맨 위에 중요한 토론을 고정할 수 있습니다.
토론 제목 아래에 토론 제목을 입력하고 쓰기 아래에 토론 본문을 입력합니다.
토론 시작을 선택합니다.
GitHub가 문제 및 토론을 통해 공동 작업을 지원하는 방법을 설명합니다. 이제 알림을 관리하고, 스레드를 구독하고, GitHub 페이지를 시작하는 방법을 살펴보겠습니다.
의견을 답변으로 표시
Q&A 스타일 토론에서 주석을 원래 질문에 대한 수락된 답변으로 표시할 수 있습니다.
- 토론으로 이동합니다.
- 원래 질문에 가장 잘 대답하는 메모를 찾습니다.
- 메모 아래에 답변으로 표시 를 선택합니다.
주석이 강조 표시되어 다른 사용자가 솔루션을 빠르게 쉽게 찾을 수 있습니다. 필요한 경우 대답의 표시를 해제할 수도 있습니다.
토론을 이슈로 변환
토론이 추적해야 하는 작업으로 이어지는 경우 토론을 문제로 변환할 수 있습니다.
- 변환할 토론으로 이동합니다.
- 토론의
...오른쪽 위에 있는 (점 3개) 메뉴를 선택합니다. - 문제로 변환을 선택합니다.
- 변환을 확인하고 리포지토리를 선택하여 새 문제를 만듭니다.
이렇게 하면 커뮤니티 대화에서 시작된 실행 가능한 작업을 추적할 수 있습니다.
토론 고정
더 나은 가시성을 위해 중요한 토론을 토론 페이지의 맨 위에 고정할 수 있습니다.
- 고정하려는 토론으로 이동합니다.
- 토론의
...오른쪽 위에 있는 (점 3개) 메뉴를 선택합니다. - 토론 고정을 선택합니다.
고정된 토론은 커뮤니티에서 알아차릴 공지 사항, 중요한 질문 또는 진행 중인 주제를 강조 표시하는 데 유용합니다.