github contributor로 기여하기

* 처음으로 Pull Request를 성공하고, 그 과정을 나중을 위해 기록해둠

 

1. 기존 기여 절차 확인

github contributor가 되려면 원하는 github repository의 안내 문서를 확인해본다.

예를 들어, tensorflow/docs의 경우 번역가로 기여할 수 있다. 한국어 번역 안내 md 파일(https://github.com/tensorflow/docs/tree/master/site/ko)을 보면 처음 시작하는 경우 메일에 번역 시작을 알리고, 구글 스프레드 시트에 기록하도록 잘 안내되어있다.

 

2. repository Fork 하기

repository의 내용을 수정하여 커밋하기 위해 내 저장소로 Fork해온다.

3. 기여할 내용 작성

(안내 문서에 따라 필요한 절차 ex. 스프레드 시트 작성 및 메일 작성 을 마치고) 기존 문서의 오타 정정 혹은 새로운 번역 파일 추가 등 작업을 진행하고 커밋한다. (내 저장소에서 변경하였기 때문에 이 과정은 기존의 github repository의 commit 과정과 동일하게 진행하였다)

 

4. (텐서플로 등의 경우) CLA 확인

내가 수정한 내용을 Merge해달라는 Pull Request를 보내기 전에 기존 Pull Request 목록을 확인해보면 요청이 거부된 사례들이 있다. tensorflow/docs를 보면 CLA로 인해 거부되는 경우가 많이 보인다.

Contributor License Agreement의 약자로 구글 개발자 페이지(https://cla.developers.google.com/)에 들어가서 동의를 누르면 금방 적용이 된다. 

5. Pull Request 요청

내 저장소에서 new pull request 버튼을 클릭하여 본 저장소의 master 로 PR 요청을 보낸다. 

6. Pull Request 가 바로 Merge 될 수 없는 경우

수정 요청이 들어온 경우, 내 저장소에서 수정할 내용을 고치고 commit을 한다. 그러면 바로 기존의 Pull Request 내에도 commit 추가가 반영되어있다. (아래의 출처에 따르면 PR을 한 경우 내 저장소의 내용이 한 branch로 인식된다)

 

 

cf) 초보몽키의 개발공부로그

Pull Request 과정에 관한 상세한 설명

https://wayhome25.github.io/git/2017/07/08/git-first-pull-request-story/

git 초보를 위한 풀리퀘스트(pull request) 방법 · 초보몽키의 개발공부로그