오픈소스에 기여하는 것은 개발자로 성장하는 데 있어 정말 중요한 경험이다. 하지만 처음 도전하려고 하면 막연하고 어렵게 느껴지기도 한다. 그래서 이번 학습에서는 first-contributions라는 오픈소스 프로젝트를 활용해 기초적인 기여 과정을 연습해 보려고 한다. 이 과정을 통해 Git과 GitHub의 기본적인 사용법뿐만 아니라, Pull Request(PR)를 제출하는 방법까지 실습할 수 있다.
first-contributions 프로젝트란?
first-contributions는 오픈소스 초보자들이 기여 과정을 안전하고 쉽게 연습해볼 수 있도록 도와주는 프로젝트이다. 처음 기여자를 위한 안내서를 제공하며, 별도의 작업 공간에서 실습을 진행할 수 있다. 누구에게나 열려있는 프로젝트이니 부담 갖지 않고 첫 걸음을 내딛어 보면 된다.
이 프로젝트의 주요 목표는 단순하다:
- Git과 GitHub에 익숙해지기
- 첫 Pull Request 경험하기
- 오픈소스 기여를 두려워하지 않게 만들기
첫 기여를 위한 준비: 가이드라인
목표
Contributors.md 파일에 자신의 이름을 추가하는 것이 이번 학습의 목표이다. 이 과정은 CLI(Command Line Interface)를 사용해도 되고, GitHub 웹 인터페이스를 통해서도 수행할 수 있다. 여기서는 두 가지 방법을 모두 안내한다.
중요한 점
- 다른 기여자의 코드를 변경하거나 삭제하지 않도록 주의해야 한다.
- 요청받지 않은 파일을 업로드하거나 불필요한 변경 사항을 포함하지 않아야 한다.
- PR 제목과 설명은 간결하고 명확하게 작성해야 한다.
CLI(Command Line Interface)로 PR 보내기
CLI를 이용하면 더욱 개발 환경에 가까운 방식으로 실습할 수 있다. 다음은 세부 단계이다:
1. 저장소 Fork
GitHub에서 first-contributions 저장소를 자신의 계정으로 포크(Fork)해야 한다. 저장소 페이지 오른쪽 상단에 있는 Fork 버튼을 클릭하면 된다.
2. 저장소 Clone
포크한 저장소를 자신의 로컬 컴퓨터로 복사해야 한다. 터미널을 열고 아래 명령어를 실행하면 된다:
git clone https://github.com/본인계정명/first-contributions.git
3. 작업 디렉토리 이동
클론한 디렉토리로 이동해야 한다:
cd first-contributions
4. 브랜치 생성
새로운 브랜치를 만들어 작업 공간을 분리해야 한다. 브랜치 이름은 자유롭게 설정할 수 있다:
git checkout -b add-your-name
5. 이름 추가
Contributors.md 파일을 텍스트 편집기로 열고 자신의 이름을 원하는 위치에 추가한 후 저장하면 된다.
6. 변경 사항 Commit
수정한 내용을 Git에 저장하면 된다:
git add Contributors.md
git commit -m "Add 본인이름 to Contributors list"
7. 변경 사항 Push
다시 원격 저장소로 변경 사항을 푸시해야 한다:
git push origin add-your-name
8. Pull Request 생성
GitHub 페이지에 접속하여 방금 푸시한 브랜치를 선택해야 한다. 이후 'Compare & pull request' 버튼을 클릭하여 PR을 제출하면 된다.
GitHub 웹 인터페이스로 PR 보내기
Git을 설치하기 어렵거나 CLI 명령어가 익숙하지 않다면 웹 인터페이스를 활용하는 것도 좋은 방법이다.
1. 파일 편집
GitHub에서 Contributors.md 파일을 찾아 열어야 한다. 오른쪽 상단의 연필 모양 아이콘(파일 편집 버튼)을 클릭하면 된다.
2. 이름 추가
파일에 자신의 이름을 추가하고 하단의 'Commit changes' 영역까지 이동해야 한다.
3. 브랜치 생성 및 변경 제안
'Commit changes' 버튼을 선택하기 전에 'Create a new branch for this commit...' 옵션을 활성화하고, PR 생성을 제안하도록 한다.
4. PR 생성
변경 사항을 확인한 다음 'Create pull request' 버튼을 클릭하여 제출을 완료하면 된다.
오픈소스 탐색 팁
기여 과정을 마쳤다면, 더 다양한 오픈소스에 기여해 보면 된다. 아래 방법들은 초보자들에게 적합한 프로젝트를 찾을 때 큰 도움이 될 수 있다.
- GitHub Explore 이용하기: GitHub 메인 페이지의
Explore탭에서 트렌딩 프로젝트를 검색할 수 있다. - 친절한 이슈 찾기:
good first issue라벨로 검색하면 초보자도 해결하기 좋은 이슈를 쉽게 찾을 수 있다. - 기술 태그 사용하기:
javascript,python등 관심 있는 기술로 검색하고 관련된 프로젝트를 탐색하면 된다. - Awesome Lists 참고하기: 특정 주제에 대해 정리된 'Awesome' 리스트를 활용하면 유용한 프로젝트를 찾을 수 있다.
오픈소스 기여는 지식뿐만 아니라 협업 능력도 키울 수 있는 좋은 기회이다. 이번 학습을 통해 첫 기여를 성공적으로 마치고, 꾸준히 다양한 프로젝트에 도전해 보면 좋겠다.
'Programmers' 카테고리의 다른 글
| [76일차]오픈소스 프로젝트 구축 및 자동화 (0) | 2026.01.07 |
|---|---|
| [75일차]오픈소스 탐색과 기여 (0) | 2026.01.06 |
| [73일차]첫 오픈 소스 기여 & 프로젝트 발굴하기 (0) | 2025.12.24 |
| [72일차]오픈 소스 기여 심화 (0) | 2025.12.23 |
| [71일차]오픈소스 기여 방법 (0) | 2025.12.22 |