끌어오기 요청을 만들 때 팀에 변경 내용을 검토하고 피드백을 제공하도록 요청합니다. 이 가이드에서는 공동 작업과 리뷰의 품질을 향상할 수 있도록 팀을 쉽게 검토하고 정보를 유지할 수 있는 끌어오기 요청을 만드는 모범 사례를 제공합니다.
변경 내용을 검토하기 쉽게 만들기
끌어오기 요청의 명확한 컨텍스트를 사용하면 검토자가 변경한 내용과 중요한 이유를 빠르게 확인할 수 있습니다. 이렇게 하면 검토 프로세스가 더 빠르고 원활해지고 앞뒤로 왔다 갔다 하는 일이 줄며 팀이 더 나은 피드백을 제공하고 자신감 있는 결정을 내리는 데 도움이 됩니다. 끌어오기 요청 만들기에 대한 자세한 내용은 끌어오기 요청 만들기을(를) 참조하세요.
작은 PR 작성
단일 목적을 충족하는 작고 집중적인 끌어오기 요청을 만드는 것을 목표로 합니다. 더 작은 끌어오기 요청은 더 쉽고 빠르게 검토 및 병합하고, 버그를 도입할 공간을 줄이고, 변경 내용의 보다 명확한 기록을 제공합니다.
먼저 사용자 고유의 끌어오기 요청 검토
제출하기 전에 사용자 고유의 끌어오기 요청을 검토, 빌드 및 테스트합니다. 이렇게 하면 다른 사용자가 검토를 시작하기 전에 누락되었을 수 있는 오류 또는 오타를 잡을 수 있습니다.
컨텍스트 및 참고 자료 제공
검토자가 끌어오기 요청이 수행하는 작업을 빠르게 이해할 수 있도록 끌어오기 요청에 대한 명확한 제목과 설명을 작성합니다. 끌어오기 요청 본문에 다음을 포함합니다.
- 끌어오기 요청의 목적
- 변경된 내용에 대한 개요
- 문제 추적 또는 이전 대화와 같은 추가 컨텍스트에 대한 링크
검토자를 돕기 위해 필요한 피드백 유형을 공유합니다. 예를 들어 간단히 보기나 심층 비판이 필요한가요?
끌어오기 요청이 여러 파일에 대한 변경 내용으로 구성된 경우 검토자에게 파일을 검토할 순서에 대한 지침을 제공합니다. 시작할 위치와 검토를 진행하는 방법을 권장합니다.
팀 정보 유지
끌어오기 요청은 문서 코드 변경 이상의 작업을 수행할 수 있습니다. 또한 팀과 관리자에게 작업 상태에 대한 정보를 유지할 수 있는 강력한 방법입니다. 끌어오기 요청에서 진행률을 표시함으로써 별도의 업데이트에 대한 필요성을 줄이고 모든 사용자가 계속 정렬되도록 할 수 있습니다.
관련 문제 또는 프로젝트에 연결
끌어오기 요청을 관련 문제 또는 프로젝트 보드에 연결하여 작업이 더 큰 프로젝트에 어떻게 적합한지 보여 줍니다.
- 설명에
Closes ISSUE-LINK와 같은 키워드를 추가하여 끌어오기 요청이 병합될 때 문제를 자동으로 연결하고 닫습니다. - Projects를 사용하여 작업을 추적하고 끌어오기 요청에서 프로젝트에 연결하여 진행 상황을 한 곳에서 쉽게 추적할 수 있습니다. Projects 정보을(를) 참조하세요.
레이블을 사용하여 상태 강조 표시
끌어오기 요청에 상태 레이블을 추가하여 검토, 차단, 진행 중인지 여부를 표시합니다. 이렇게 하면 검토자가 작업의 상태를 한눈에 파악할 수 있습니다. 자세한 내용은 레이블 관리을(를) 참조하세요.