Share via


오픈 소스 제품에 대한 GitHub 문제 만들기

이 문서에서는 오픈 소스 제품과 관련된 Microsoft Learn 설명서에 대한 GitHub 문제를 만드는 방법을 설명합니다. 또한 다른 사용자의 문제를 정독하고 자신의 의견을 추가하거나 PR(끌어오기 요청)을 열어 문제를 해결하는 방법을 설명합니다.

오픈 소스 제품 설명서는 진행 중인 지속적인 작업입니다. 기여자로부터 좋은 GitHub 문제를 수신하면 커뮤니티의 가장 높은 우선 순위에 집중하는 데 도움이 됩니다.

물론 문제를 해결하는 방법을 알고 있는 경우 문제를 여는 대신 직접 변경하도록 초대합니다.

참고 항목

오픈 소스 피드백 환경을 사용하는 오픈 소스 제품만 GitHub 문제를 수락합니다. 자세한 내용 및 참여 리포지토리 목록은 오픈 소스 환경 사용을 참조 하세요. Microsoft Learn 플랫폼에서 GitHub가 아닌 피드백을 제공하는 방법에 대한 자세한 내용은 Microsoft Learn에 대한 피드백 제공을 참조 하세요.

필수 조건

문제 만들기

  1. 주석을 달려는 문서로 이동합니다.

  2. 문서 아래쪽으로 스크롤하면 피드백을 제출하는 옵션이 표시됩니다. 문서 문제 열기를 선택하여 새 문제를 만듭니다. 이 피드백은 콘텐츠와 관련이 있으며 GitHub에서 문제로 추적됩니다.

    피드백 옵션을 보여 주는 문서 하단의 스크린샷.

    필요에 따라 제품 피드백 제공을 선택하여 제품 자체에 대한 피드백을 제공할 수 있는 대상(예: 피드백 포털, GitHub, 이메일 주소)으로 이동합니다. 이 피드백은 콘텐츠와 독립적이며 원래 문서와 아무런 관계가 없습니다.

  3. 시스템에서 보고 있는 문서의 콘텐츠를 저장하는 GitHub 리포지토리에서 새 문제를 엽니다. 제목 및 설명을 추가합니다. 다른 모든 필드는 자동으로 채워집니다. 완료되면 새 문제 제출을 선택합니다.

    GitHub의 새 문제 양식 스크린샷

    더 많은 세부 정보를 제공할수록 문제가 더 유용합니다. 검색한 정보 또는 이 문서에 사용된 검색어를 알려주세요. 시작하기가 어렵다면 새로운 기술을 어떻게 활용하면 좋을지 공유해 주세요. 문제를 이해하는 데 도움이 되는 스크린샷 또는 파일을 추가할 수도 있습니다.

정말 간단하죠. 이제 문제가 문제 큐에 추가됩니다. 문제를 통해 필요한 사항에 대한 대화가 시작됩니다. 콘텐츠 팀은 추가 가능한 내용에 대한 아이디어로 이러한 문제에 대응하고 의견을 요청합니다.

문제에 대한 주석

GitHub 문제를 지원하는 리포지토리에서 문제에 대해 언급할 수 있습니다. 만든 문제에 사용자 고유의 의견을 추가할 수도 있습니다.

  1. 주석을 달고 싶은 문제를 찾습니다. 브라우저에서 문제를 확인하려는 GitHub 리포지토리로 이동합니다. 문제 탭을 선택하여 해당 리포지토리에 대해 열려 있는 문제를 확인합니다. 리포지토리에 많은 문제가 있는 경우 필터 막대를 사용하여 레이블, 작성자 등을 필터링합니다. 또는 검색 창을 사용하여 특정 쿼리를 찾습니다. 사용자에게 호소하는 문제를 찾으면 해당 문제를 선택하여 엽니다.

    오픈 소스 피드백 환경을 사용하는 오픈 소스 제품만 GitHub 문제를 수락합니다. 자세한 내용 및 참여 리포지토리 목록은 오픈 소스 환경 사용을 참조 하세요.

  2. 다른 사용자가 이미 추가한 문제 및 메모를 읽어보십시오. 메모를 추가하려면 문제 맨 아래로 스크롤하여 메모 남기기 상자에 메모를 입력합니다. 완료되면 설명을 선택합니다.

    아래쪽에 주석 상자가 있는 GitHub 문제의 스크린샷.

문제 해결을 위한 끌어오기 요청 열기

문제를 탐색할 때 해결 방법을 알고 있는 문제를 찾을 수 있습니다. 이 경우 문제를 해결하기 위해 PR을 열 수 있습니다. 자세한 내용은 브라우저에서 설명서 편집을 참조 하세요.

문제를 해결하기 위해 PR을 열면 문제로 돌아가서 PR에 연결되는 주석을 추가합니다. 이렇게 하면 문제 및 PR을 함께 추적하는 데 도움이 됩니다. 파운드 기호(#)와 PR 번호를 사용하여 PR에 연결합니다. 예를 들어 PR 번호가 4210인 경우 메모에 입력 #4210 합니다.

PR에 대한 링크가 있는 GitHub 문제 주석 상자의 스크린샷