GitubSession

Git을 사용한 오픈 소스 프로젝트에 기여합니다

우리 프로젝트에 오신 것을 환영합니다! 우리는 당신이 오픈 소스 개발에 기여하고 있다는 것을 기쁘게 생각합니다. 이 안내서는 귀하의 기여를 쉽고 성공적으로 만들기 위해 필수 GIT 명령 및 모범 사례를 안내합니다.

목차

1. 저장소를 포킹합니다
2. 저장소 복제
3. 지점 만들기
4. 변경
5. 변화를 커밋합니다
6. 변화를 추진합니다
7. 풀 요청 생성
8. 포크 동기
9. 좋은 커밋 메시지를 작성하기위한 팁

---

1. 저장소를 포킹합니다

기여를 시작하기 전에 저장소를 포크해야합니다. Forking은 자신의 Github 계정에 따라 저장소 사본을 만듭니다.

단계 :

1. 저장소 페이지로 이동하십시오.
2. 오른쪽 상단 코너에서 "포크"버튼을 클릭하십시오.
3. 이제 GitHub 계정에 저장소 사본이 있습니다.

---

2. 저장소 복제

저장소를 포킹 한 후에는 로컬 컴퓨터로 복제하여 작업 할 수 있도록해야합니다.

git clone https://github.com/your-username/repository-name.git

---

3. 지점 만들기

저장소를 복제 한 후 변경 사항을 수행 할 새 지점을 만듭니다. 메인 지점과의 충돌을 피하기 위해 항상 별도의 지점에서 작업하십시오.

git checkout -b feature/your-branch-name

---

4. 변화 만들기

이제 당신이 당신의 지점에 있으므로, 코드, 문서 또는 프로젝트의 다른 부분을 변경하십시오. 다음 단계로 넘어 가기 전에 모든 것을 테스트하십시오.

---

5. 변화를 커밋합니다

변경이 완료되면 이제 변경해야합니다. 다음 단계를 따르십시오.

1. 스테이징 영역에 변경 사항을 추가하십시오.

git add .

2. 명확하고 설명적인 메시지로 변경 사항을 커밋하십시오.

git commit -m " Your descriptive message here "

3. 커밋 메시지가 변경 사항을 명확하게 설명해야합니다.

6. 변화를 추진합니다

로컬에서 변경 사항을 커밋 한 후 지점을 Github 저장소로 밀어 넣으십시오.

git push origin feature/your-branch-name

이렇게하면 지점을 Github의 포크 리포지토리에 업로드합니다.

7. 풀 요청 생성

변경 사항이 GitHub로 추진되면 PR (Pull Requess)을 제출할 준비가되어있어 관리자가 작업을 검토 할 수 있습니다.

• Github의 포크 리포지토리로 이동하십시오.
  
• "비교 및 당기 요청"버튼을 클릭하십시오.
  
• 제목과 변경 사항에 대한 자세한 설명을 제공하십시오.
  
• 풀 요청을 제출하십시오.
  
• 검토 후 관리자는 PR을 통합하거나 수정에 대한 피드백을 제공합니다.
  

8. 포크 동기

작업하는 동안 원래 저장소가 업데이트되면 포크를 동기화하여 최신 상태로 유지할 수 있습니다. 방법은 다음과 같습니다.

1. 업스트림 리포지토리를 리모컨으로 추가하십시오.

git remote add upstream https://github.com/original-owner/repository-name.git

2. 상류 저장소에서 최신 변경 사항을 가져 오십시오.

git fetch upstream

3. 업스트림 변경을 지역 본점으로 병합하십시오.

git checkout main
git merge upstream/main

4. 업데이트 된 메인 브랜치를 포크로 밀어 넣으십시오.

git push origin main

9. 좋은 커밋 메시지를 작성하기위한 팁

• 간결하게 유지하십시오 : 50 자 미만의 커밋 메시지를 목표로하십시오.
  
• 명령적인 분위기를 사용하십시오. 예를 들어, "고정 버그"대신 "수정 버그"를 작성하십시오.
  
• 컨텍스트 제공 : 문제 번호를 포함 시키거나 변경의 목적을 설명하십시오.
  예 : 수정 #42- 사용자 인증에서 버그를 해결하십시오.