끌어오기 요청에서 제안된 변경 내용 검토

끌어오기 요청의 용도 이해

끌어오기 요청의 동기에 대한 명확한 이해를 확보하면 검토를 알리는 데 도움이 되므로 대상 지정되고 의미 있는 상태로 유지하고 끌어오기 요청 작성자의 의도 및 프로젝트 목표에 맞는 피드백을 제공할 수 있습니다.

제안된 변경 내용의 컨텍스트와 근거를 더 잘 이해할 수 있는 몇 가지 옵션이 있습니다.

컨텍스트를 위해 pull request 사이드바 사용

끌어오기 요청 사이드바에서 다음을 비롯한 중요한 컨텍스트를 찾을 수 있습니다.

• 연결된 문제 또는 토론: 이러한 문제를 검토하여 끌어오기 요청이 해결하려는 문제 또는 목표를 이해하거나 배경, 디자인 결정 또는 현재 토론과 같은 정보를 수집합니다.
• 연결된 프로젝트 또는 마일스톤: 이 끌어오기 요청이 더 큰 프로젝트 또는 예정된 릴리스에 어떻게 적합한지 검토합니다.

이 정보를 사용하여 검토를 구성하고 끌어오기 요청의 목표가 원래 의도와 일치하는지 확인합니다.

공동 파일럿 채팅를 사용하여 근거를 이해하기

끌어오기 요청의 의도를 이해하거나 변경의 모든 부분에 대한 설명을 요청하는 데 도움을 요청할 공동 파일럿 채팅 수 있습니다.

1. 끌어오기 요청 페이지의 오른쪽 위에서 검색 창 옆에 있는 단추를 클릭합니다.

공동 파일럿 채팅 는 끌어오기 요청이 프롬프트 창에 컨텍스트로 연결된 상태에서 표시됩니다.

1. 프롬프트 상자에 질문을 입력하고 Enter 키를 누릅니다. 예를 들어 다음과 같이 입력할 수 있습니다.

   • What problem does this pull request solve?
   • Why were these changes needed?
   • Summarize the goals of this PR based on the linked issue.
   • How does this PR relate to issue ISSUE-URL?

공동 파일럿 채팅 는 라인 수준 검토로 다이빙하기 전에 더 큰 그림을 명확히하는 데 도움이 될 수 있습니다.

검토 시작

1. 리포지토리 이름에서 Pull requests를 클릭합니다.

   

2. 끌어오기 요청 목록에서 검토하려는 끌어오기 요청을 클릭합니다.

3. 끌어오기 요청에서 파일 변경됨을 클릭합니다.

   통합 또는 분할 보기를 클릭하고 선택하여 이 탭에서 차이 보기의 형식을 변경할 수 있습니다. 선택한 옵션은 다른 풀 리퀘스트의 차이를 확인할 때 적용됩니다.

   

   공백 차이를 숨기도록 선택할 수도 있습니다. 선택한 항목은 이 끌어오기 요청에만 적용되며 다음에 이 페이지를 방문할 때 기억됩니다.

4. 필요에 따라 파일을 필터링하여 검토하려는 파일만 표시하거나 파일 트리를 사용하여 특정 파일로 이동합니다. 자세한 내용은 끌어오기 요청에서 파일 필터링을(를) 참조하세요.

5. 선택적으로, GitHub Copilot Enterprise에 대한 액세스 권한이 있는 경우, 끌어오기 요청에 대한 파일의 변경 사항을 확인하려면 파일의 오른쪽 상단에 있는 를 클릭하고, 이 차이에 대해 Copilot에게 물어보기를 클릭한 다음, "이러한 변경 내용 설명"과 같은 요청을 입력할 수 있습니다. 자세한 내용은 GitHub에서 GitHub Copilot에 질문하기을(를) 참조하세요.

6. 설명을 추가할 코드 줄을 마우스로 가리키고 파란색 설명 아이콘을 클릭합니다.

   

7. 선택적으로 여러 줄에 설명을 추가할 수 있습니다. 줄 범위를 선택하려면 메모할 첫 번째 줄의 줄 번호를 클릭한 다음 마지막 줄로 끌어다 놓거나 Shift 키를 누 른 채 마지막 줄 번호를 클릭합니다. 그런 다음 메모할 마지막 줄에서 파란색 메모 아이콘을 클릭할 수 있습니다. 또는 설명을 추가할 첫 번째 줄 옆에 있는 파란색 메모 아이콘을 클릭한 다음, 설명을 추가할 마지막 줄로 끌어다 놓을 수 있습니다.

8. 주석 필드에 주석을 입력합니다.

9. 필요에 따라 줄에 대한 특정 변경을 제안하려면 을 클릭한 다음, 제안 블록 내에서 텍스트를 편집합니다.

   

10. 파일에 직접 메모를 달려면 파일 오른쪽에서 을(를) 클릭하고 메모를 입력합니다.

    

11. 완료되면 검토 시작을 클릭합니다. 이미 검토를 시작한 경우 검토 주석 추가를 클릭할 수 있습니다.

검토를 제출하기 전에는 줄 주석이 _보류 중_이며 자신에게만 표시됩니다. 검토를 제출하기 전에 언제든지 보류 중인 주석을 편집할 수 있습니다. 보류 중인 모든 주석을 포함하여 보류 중인 검토를 취소하려면 변경된 코드 위에 있는 변경 내용 검토를 클릭한 다음 검토 중단을 클릭합니다.

끌어오기 요청의 변경 내용 이해

GitHub Copilot 는 특정 커밋에 대한 컨텍스트 및 설명을 제공하여 끌어오기 요청의 변경 내용을 빠르게 이해하는 데 도움이 될 수 있습니다. 특정 변경의 목적에 대해 잘 모르거나 더 넓은 코드베이스에 맞는 방법에 대한 자세한 정보가 필요한 경우 개별 커밋에 대해 질문 Copilot 할 수 있습니다.

1. GitHub에서 커밋으로 이동합니다.

2. GitHub의 페이지 오른쪽 위에서 검색 창 옆에 있는 아이콘을 클릭합니다.

   깃허브 코파일럿 채팅 패널이 표시됩니다. 패널 크기를 조정하려면 위쪽 또는 왼쪽 가장자리를 클릭하고 끕니다.

3. 패널에 Copilot과의 이전 대화가 포함된 경우 Copilot 패널의 오른쪽 위에 있는 더하기 기호 아이콘을 클릭하여 새 대화를 시작합니다.

4. 채팅 패널 아래쪽의 Copilot "질문 Copilot" 상자에 질문을 입력하고 Enter 키를 누릅니 다. 예를 들어 다음과 같이 입력할 수 있습니다.

   • Summarize the changes in this commit

   • Who committed these changes?

   • When was this commit made?

   팁

   커밋으로 이동하는 대신 커밋에 대한 SHA를 알고 있는 경우 메시지에 SHA를 포함하여 리포지토리의 모든 페이지에서 커밋에 Copilot 대해 요청할 GitHub 수 있습니다. 예를 들어 What changed in commit a778e0eab?

5. 필요에 따라 질문을 제출한 후 텍스트 상자에서 아이콘을 클릭하여 응답을 중지할 수 있습니다.

종속성 변경 검토

끌어오기 요청에 종속성에 대한 변경이 포함된 경우 매니페스트 또는 잠금 파일에 대한 종속성 검토를 사용하여 변경된 내용을 확인하고 변경 내용에 보안 취약성이 있는지 확인할 수 있습니다. 자세한 내용은 끌어오기 요청에서 종속성 변경 검토을(를) 참조하세요.

1. 끌어오기 요청에서 파일 변경됨을 클릭합니다.

   

2. 매니페스트 또는 잠금 파일의 헤더 오른쪽에서 리치 디프(rich diff) 버튼을 클릭하여 종속성 검토를 표시합니다.

   

3. 종속성을 변경하지 않는 매니페스트 또는 잠금 파일이 변경되거나, GitHub가 구문 분석할 수 없고 결과적으로 종속성 검토에 표시되지 않는 종속성이 있을 수 있으므로 원본 diff도 검토할 수 있습니다.

   원본 diff 보기로 돌아가려면 단추를 클릭합니다.

   

파일을 확인한 것으로 표시

파일 검토를 완료한 후에는 파일을 검토 완료로 표시할 수 있고, 그러면 파일이 축소됩니다. 파일을 확인한 후 파일이 변경되면 확인한 것으로 표시되지 않습니다.

1. 끌어오기 요청에서 파일 변경됨을 클릭합니다.

   

2. 검토를 완료한 파일의 헤더 오른쪽에서 확인함을 선택합니다.

   

리뷰 제출

끌어오기 요청에서 원하는 모든 파일을 검토한 후 검토를 제출합니다.

1. 끌어오기 요청에서 파일 변경됨을 클릭합니다.

   

2. 변경된 코드 위에서 변경 내용 검토를 클릭합니다.

   

3. 제안된 변경 내용에 대한 피드백을 요약한 설명을 입력합니다.

4. 남기고자 하는 검토 유형을 선택합니다.

   • 변경 내용을 명시적으로 승인하거나 추가 변경을 요청하지 않은 채 일반 피드백을 남기려면 주석을 선택합니다.
   • 피드백을 제출하고 끌어오기 요청에서 제안된 변경 내용의 병합을 승인하려면 승인을 선택합니다.
   • 끌어오기 요청을 병합하기 전에 해결해야 하는 피드백을 제출하려면 변경 내용 요청을 선택합니다.

5. 리뷰 제출을 클릭합니다.