GitHub 흐름 살펴보기

완료됨

GitHub는 프로젝트에서 협업을 사용하도록 설정하는 가장 좋은 도구입니다. GitHub 흐름은 GitHub에 대해 제안된 분기 기반 워크플로입니다.

참고

GitHub 흐름을 구현하려면 GitHub 계정과 리포지토리가 필요합니다. "GitHub 등록" 및 "리포지토리 만들기"를 참조하세요.

GitHub 웹 인터페이스, 명령줄, GitHub CLI 또는 GitHub Desktop을 통해 GitHub 흐름의 모든 단계를 완료할 수 있습니다.

첫 번째 단계에서는 기본 분기에 영향을 주지 않고 작업할 리포지토리에 분기를 만들고 협력자에게 작업을 검토할 기회를 제공합니다.

자세한 내용은 “리포지토리 내에서 분기 만들기 및 삭제”를 참조하세요.

Screenshot of a branching model representing the branch creation.

리포지토리를 원하는 대로 변경합니다. 실수한 경우 되돌리거나 추가 변경 사항을 푸시하여 수정할 수 있습니다.

변경 내용을 분기로 커밋하고 푸시하여 원격 스토리지에 작업을 백업하고 각 커밋에 설명 메시지를 제공합니다. 각 커밋에는 격리된 완전한 변경 내용이 포함되어야 하므로 다른 방법을 사용하면 쉽게 되돌릴 수 있습니다.

프로젝트에서 협업하는 모든 사용자는 작업을 보고 질문에 답변하며 제안 또는 기여를 할 수 있습니다. 피드백을 요청할 준비가 될 때까지 계속해서 분기를 만들고 커밋하며 변경 사항을 분기에 푸시합니다.

각 변경 사항에 대해 별도의 분기를 만들면 검토자가 피드백을 제공하거나 차이점을 쉽게 이해할 수 있습니다.

준비가 되면 끌어오기 요청을 만들어 협력자에게 변경 내용에 대한 피드백을 요청할 수 있습니다. "끌어오기 요청 만들기"를 참조하세요.

끌어오기 요청 검토는 협업의 가장 중요한 기능 중 하나입니다. 변경 내용을 병합하기 전에 동료 및 팀의 승인을 요구할 수 있습니다. 또한 변경 내용을 완료하기 전에 초기 피드백 또는 조언을 원하는 경우 초안으로 표시할 수 있습니다.

Screenshot of a branching model representing an open a pull request.

제안된 변경 내용 및 해결 중인 문제를 사용하여 끌어오기 요청을 최대한 많이 설명합니다. 이미지, 링크, 관련 문제 또는 정보를 추가하여 변경 내용을 문서화하고 검토자가 각 파일을 열지 않고 PR을 이해하는 데 도움을 줄 수 있습니다. "기본 쓰기 및 서식 지정 구문" 및 "문제에 끌어오기 요청 연결"을 참조하세요.

Screenshot of open a pull request representation with description field, related issue and a checklist template.

PR 품질 및 설명서를 개선하고 검토자에게 명시적으로 지적하는 또 다른 방법은 주석 세션 영역을 사용하는 것입니다. @mention을 실행하거나 특정 사용자 또는 팀의 검토를 요청할 수도 있습니다.

Screenshot of pull request comment field.

끌어오기 요청이 생성되거나 끌어오기 요청에서 실행되도록 확인하는 경우 특정 팀 또는 사용자의 검토를 자동으로 요청하는 등 그 밖의 끌어오기 요청 구성이 있습니다. 자세한 내용은 "상태 검사 정보" 및 "보호된 분기 정보"를 참조하십시오.

검토자의 주석 및 유효성 검사가 끝나면 변경 내용을 병합할 준비가 되어 있어야 하며 끌어오기 요청을 승인할 수 있습니다. 끌어오기 요청 병합을 참조하세요.

충돌이 있는 경우 GitHub는 문제를 해결하도록 알릴 것입니다. "병합 충돌 처리."

Screenshot of a branching model representing the branch merge.

끌어오기 요청이 성공적으로 병합된 후에는 원격 분기를 계속 유지하지 않아도 됩니다. 다른 사용자가 실수로 이전 분기를 사용하지 못하도록 분기를 삭제할 수 있습니다. 자세한 내용은 “끌어오기 요청에서 분기 삭제 및 복원”을 참조하세요.

참고

GitHub는 끌어오기 요청을 복원하거나 되돌려야 할 경우 커밋 및 병합 기록을 유지합니다.