오픈소스 프로젝트 기여하기
Luke Han
※ 이 문서는 Github로 제공되는 오픈소스 프로젝트에 참여하기 위한 방법을 설명하고 있습니다.
※ 기본적으로 Git 사용법을 알고 있어야 합니다.
※ 해당 문서는 HamoniKR 팀의 hamonikr-apphamonia 프로젝트(https://github.com/hamonikr/hamonikr-apphamonia)에 참여하는 방법에 대해 설명하도록 하겠습니다.
레파지토리 접속
기여할 오픈소스 프로젝트를 선정하여 해당 프로젝트의 레파지토리(repogitory)로 들어갑니다.
페이지 우측 상단에 Fork 라는 항목을 확인할 수 있습니다.
Fork 란 해당 저장소의 소스코드를 내 개인 저장소에 동일하게 복제(Fork)하는 것을 말합니다.
포크하기
Fork 버튼을 클릭하여 해당 저장소를 포크 하도록 합니다.
진행중인 이미지 입니다.
포크가 완료되었습니다.
좌측 상단을 보시면 자신의 저장소에 레파지토리가 복사 된 것을 확인할 수 있습니다.
내 저장소에 포크된 프로젝트를 clone 하여 소스코드를 수정하시면 됩니다.
수정이 완료된 코드는 다시 내 저장소에 포크된 프로젝트에 반영하도록 합니다.
Pull request
수정한 프로젝트가 반영될 수 있도록 pull request 요청을 합니다
좌측 상단의 ' New pull request' 버튼을 클릭합니다.
위와 같은 화면을 확인할 수 있습니다.
하단을 보시면 수정된 소스코드 내용을 확인할 수 있습니다.
상단 좌측을 보시면 리퀘스트 요청할 대상 프로젝트 및 브랜치를 설정할 수 있으며, 우측을 보시면 요청할 내 프로젝트 및 브랜치를 설정할 수 있습니다.
설정이 완료되면 'Create pull request'를 클릭하여 요청을 진행합니다.
요청을 진행하기 위해 어떤 항목이 어떻게 수정 되었는지 설명을 적습니다.
커미터(원본 프로젝트를 수정 관리하는 사람)및 다른 사람들이 이해하기 쉽고 자세하게 적도록 합니다.
작성이 완료되면 'Create pull request'를 클릭합니다.
원본 프로젝트에 접속하여 상단 메뉴 Pull requests 를 클릭합니다.
위와 같이 요청한 request 항목을 확인할 수 있습니다.
프로젝트의 커미터가 해당 요청을 확인하고 해당 요청에 대해 피드백(코드합치가, 코드리뷰등 등)을 할 것입니다.
오픈소스 프로젝트에 개발자로서 기여하기 위해서 해당 프로젝트의 사용 언어, 코드에 대한 이해가 필요합니다.
프로젝트에 대한 이해 및 언어를 잘 알고 있다면 참여하기 어렵지 않겠지만 초보자라면 쉽지 않을 것 입니다.
오픈소스 프로젝트는 개발 이외에도 참여할 수 있는 다양한 방법이 있습니다.
문서 작성 혹은 문서 번역, 오탈자 수정, 한글화 등 등의 방법으로도 기여가 가능합니다.
자신에게 맞는 방식으로 오픈소스 프로젝트에 참여하여 기여할 수 있습니다.