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

끌어오기 요청의 용도 이해

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

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

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

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

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

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

검토 시작

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

   

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

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

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

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

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

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

   

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

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

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

   

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

   

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

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

          ![리뷰의 댓글 필드 스크린샷. "검토 중단" 단추는 진한 주황색으로 표시됩니다.](/assets/images/help/pull_requests/abandon-review-button.png)

종속성 변경 검토

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

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

   

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

   

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

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

   

파일을 확인한 것으로 표시

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

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

   

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

   

리뷰 제출

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

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

   

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

   

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

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

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

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