Skip to main content

GitHub 토론에 대한 빠른 시작

기존 리포지토리 또는 조직에서 GitHub Discussions를 사용하도록 설정하고 커뮤니티와 대화를 시작합니다.

소개

GitHub Discussions는 오픈 소스 또는 내부 프로젝트를 중심으로 커뮤니티를 위한 공동 커뮤니케이션 포럼입니다. 토론은 투명하고 액세스할 수 있어야 하며 프로젝트에서 추적할 필요가 없는 대화를 위한 기능이지만 GitHub Issues과(와) 달리 코드와 관련이 없습니다. 토론은 공개 포럼에서 편안하고 원활하게 대화를 이어갈 수 있도록 합니다.

토론은 소통하고 정보를 찾을 수 있는 중앙 집중식 영역을 제공하여 공동으로 더욱 합심하여 대화할 수 있는 공간을 제공합니다.

리포지토리에서 GitHub Discussions 사용

리포지토리 소유자 및 쓰기 액세스 권한이 있는 사용자는 퍼블릭, 내부 및 프라이빗 리포지토리의 커뮤니티에 대해 GitHub Discussions를 사용하도록 설정할 수 있습니다. 토론의 표시 유형은 토론이 만들어지는 리포지토리에서 상속됩니다.

GitHub Discussions를 처음 사용하도록 설정하면 환영 게시물을 구성하도록 초대됩니다.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 이름 아래에서 Settings(설정)를 클릭합니다.

    GitHub 리포지토리의 탭 스크린샷. "설정" 옵션이 진한 주황색으로 표시됩니다.

  3. "기능" 섹션까지 아래로 스크롤하고 토론 설정을 클릭합니다.

    리포지토리 설정의 "토론" 옵션 스크린샷 "토론 설정"이라는 녹색 단추가 진한 주황색으로 표시됩니다.

  4. “Start a new discussion” 아래에서 커뮤니티에 대해 설정하려는 리소스 및 어조에 맞춰 템플릿을 편집합니다.

  5. 토론 시작을 클릭합니다.

조직에서 GitHub Discussions 사용

조직 소유자는 조직에 대해 GitHub Discussions을 사용하도록 설정할 수 있습니다.

조직 토론을 활성화하면 조직의 리포지토리를 조직 토론의 원본 리포지토리로 선택합니다. 기존 리포지토리를 사용하거나 조직 토론을 개최하기 위해 리포지토리를 만들 수 있습니다. 토론은 조직의 토론 페이지와 원본 리포지토리의 토론 페이지에 모두 표시됩니다.

조직에서 토론에 참여하거나 토론을 관리할 수 있는 권한은 원본 리포지토리의 사용 권한을 기준으로 합니다. 예를 들어 사용자는 조직 토론을 삭제하기 위해 원본 리포지토리에 대한 쓰기 권한이 필요합니다. 이는 리포지토리 토론을 삭제하기 위해 사용자가 리포지토리에서 쓰기 권한이 필요한 방법과 동일합니다.

언제든지 원본 리포지토리를 변경할 수 있습니다. 원본 리포지토리를 변경하면 토론이 새 원본 리포지토리로 전송되지 않습니다.

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 설정을 클릭합니다.

    조직 프로필에 있는 여러 탭의 스크린샷. "설정" 탭이 진한 주황색으로 표시됩니다.

  3. “토론”에서 이 조직에 대한 토론 사용을 선택합니다.

  4. 드롭다운 메뉴로 조직 토론의 원본 리포지토리로 사용할 리포지토리를 선택합니다.

  5. 저장을 클릭합니다.

토론에 대한 기여 환영

환영 게시물을 작성하고 해당 게시물을 GitHub Discussions 페이지에 고정하여 커뮤니티를 환영하고 리포지토리 또는 조직에서 소통하는 새로운 방법을 도입할 수 있습니다. 토론을 고정하고 잠그면 다른 사람들이 게시물이 공지 사항임을 알 수 있습니다. 공지 사항을 사용하여 사람들을 더 많은 리소스에 연결하고 커뮤니티에서 토론을 열기 위한 지침을 제공할 수 있습니다. 토론 고정에 관한 자세한 내용은 "토론 관리"을 참조하세요.

contributor를 위한 커뮤니티 지침 설정

리포지토리 토론의 경우 협력자가 리포지토리와 관련된 의미 있고 유용한 대화를 하도록 권장하는 기여 지침을 설정할 수 있습니다. 또한 리포지토리의 추가 정보를 업데이트하여 협력자가 이슈 또는 토론을 열어야 하는 시점에 대한 기대치를 전달할 수 있습니다. 프로젝트 지침 제공에 관한 자세한 내용은 "정상 기여를 위한 프로젝트 설정"을 참조하세요.

조직 토론의 경우 조직 프로필 추가 정보를 만들어 조직과 소통하는 방법에 대한 정보를 공유할 수 있습니다. 자세한 내용은 "조직의 프로필 사용자 지정"을(를) 참조하세요.

새 토론 만들기

리포지토리를 볼 수 있는 인증된 사용자는 해당 리포지토리에서 토론을 만들 수 있습니다. 마찬가지로 조직 토론은 원본 리포지토리를 기반으로 하므로 원본 리포지토리를 볼 수 있는 인증된 사용자는 해당 조직에서 토론을 만들 수 있습니다.

  1. GitHub에서 토론을 시작하려는 리포지토리 또는 조직의 기본 페이지로 이동합니다.

  2. 리포지토리 또는 조직 이름 아래에서 토론을 클릭합니다.

    GitHub 리포지토리의 탭 스크린샷. "토론"에 진한 주황색 윤곽선이 표시됩니다.

  3. 페이지 오른쪽에서 새 토론을 클릭합니다.

  4. 시작하기를 클릭하여 토론 범주를 선택합니다.

    "토론 범주 선택" 페이지의 스크린샷.  "시작" 단추가 진한 주황색으로 표시됩니다.

  5. "토론 제목"에 토론 제목을 입력하고 "쓰기" 아래에 토론 본문 내용을 입력합니다.

    새 토론의 제목과 본문 항목의 스크린샷

  6. 토론 시작을 클릭합니다.

새 설문 조사 만들기

리포지토리를 볼 수 있는 인증된 사용자는 누구나 설문 조사를 만들 수 있습니다. 마찬가지로 조직 토론은 원본 리포지토리를 기반으로 하므로 원본 리포지토리를 볼 수 있는 인증된 사용자는 해당 조직에서 설문 조사를 만들 수 있습니다.

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 리포지토리 또는 조직 이름 아래에서 토론을 클릭합니다.

    GitHub 리포지토리의 탭 스크린샷. "토론"에 진한 주황색 윤곽선이 표시됩니다.

  3. 범주 목록에서 설문 조사를 클릭합니다.

    "토론" 탭의 범주 섹션 스크린샷. "투표" 범주가 진한 주황색으로 표시됩니다.

  4. 오른쪽에서 새 토론을 클릭합니다.

  5. "토론 제목"에 제목을 입력하고, "쓰기"에는 투표의 본문이 필요한 경우 입력합니다.

    새 투표를 시작하는 페이지의 스크린샷.

  6. "투표 질문"에 투표 질문을 입력합니다.

  7. “투표 항목”에 답변을 최소 2개 입력합니다.

  8. 투표 항목을 추가하려면 옵션 추가를 클릭합니다.

    새 투표를 시작하는 페이지의 스크린샷. 더하기 아이콘과 "항목 추가"는 진한 주황색으로 표시됩니다.

  9. 설문 조사 시작을 클릭합니다.

토론 구성

리포지토리 소유자 및 리포지토리에 대한 쓰기 액세스 권한이 있는 사용자는 토론을 체계적으로 유지하기 위해 새 범주를 만들 수 있습니다. 마찬가지로 조직 토론은 원본 리포지토리를 기반으로 하므로 리포지토리 소유자와 원본 리포지토리에 대한 쓰기 권한이 있는 사용자는 조직 토론을 위한 새 범주를 만들 수 있습니다.

새 토론을 만들고 참여하는 협력자는 토론을 가장 관련성이 큰 기존 범주로 그룹화할 수 있습니다. 토론은 만든 후에 다시 분류할 수도 있습니다. 자세한 내용은 "토론 범주 관리"을(를) 참조하세요.

토론을 보다 세밀하게 구성하려면 레이블을 적용하면 됩니다. 예를 들어 레이블을 사용하여 토론 상태를 표시해 분류를 보다 효율적으로 수행할 수 있습니다. 각 리포지토리에는 문제, 끌어오기 요청 및 토론에 대한 하나의 공유 레이블 집합이 있습니다. 자세한 내용은 "레이블 관리"을(를) 참조하세요.

건전한 대화 홍보

리포지토리 또는 조직 토론을 위한 원본 리포지토리에 대한 쓰기 권한이 있는 사용자는 토론을 고정하고, 더 이상 유용하지 않거나 커뮤니티에 피해를 주는 토론을 삭제하고, 조직이 소유한 더 관련성이 큰 리포지토리로 토론을 전송하여 중요한 대화를 노출하는 데 도움이 될 수 있습니다. 자세한 내용은 "토론 관리"을(를) 참조하세요.

리포지토리 또는 조직 토론을 위한 원본 리포지토리에 대한 심사 권한이 있는 사용자는 주석을 답변으로 표시하고, 더 이상 유용하지 않거나 커뮤니티에 피해를 주는 토론을 잠그고, 아이디어가 아직 개발 초기 단계에 있을 때 이슈를 토론으로 변환하여 프로젝트의 토론을 조정하는 데 도움이 될 수 있습니다. 자세한 내용은 "토론 중재"을(를) 참조하세요.

다음 단계

범위가 명확하고 개념에서 현실로 아이디어를 이전하는 명확한 경로가 있으면 이슈를 만들고 진행 상황 추적을 시작할 수 있습니다. 토론에서 이슈를 만드는 방법에 대한 자세한 내용은 "토론 중재"를 참조하세요.