🎯 오픈 소스 프로젝트를 구성하는 다양한 역할과 참여할 수 있는 기여(Contribution) 방법을 정리합니다.

📗 Today I Learned

오픈 소스 기여

오픈 소스 구성원 역할

• 저작자 (Author) : 프로젝트를 처음 만들거나 시작한 사람 또는 조직

• 메인테이너 (Maintainer) : 프로젝트의 방향을 관리하며, 중요한 의사결정을 하는 핵심 기여자

• 커미터 (Committer) : 컨트리뷰션을 검토하고 병합하는 권한을 가진 기여자

• 컨트리뷰터 (Contributor) : 코드, 문서, 디자인 등 다양한 형태로 기여하는 모든 사람

• 사용자 (User) : 오픈 소스를 사용하는 사람. 이슈 제보, 피드백 등을 통해 간접 기여 가능

🏷️ GitHub 자동 역할 배지 정리

배지	의미	사진
Author	해당 이슈나 PR을 생성한 사람. 조직 소속 여부와 관계없이 표시됨.
Member	해당 리포지토리를 포함한 조직(Organization)의 정식 구성원.
Contributor	해당 리포지토리에 커밋 기록이 있는 사용자.
Owner	이 리포지토리를 소유한 GitHub 조직의 최고 관리자. 보통 조직 세팅과 권한을 관리하는 역할을 함.

---

컨트리뷰션 활동 유형

오픈 소스 프로젝트에 기여하는 방법은 꼭 코드 작성뿐만이 아닙니다. 작은 수정부터 기능 개선까지, 아래와 같은 다양한 형태의 활동이 모두 소중한 기여가 됩니다.

• 오타 수정 : 문서나 주석 등에 있는 오탈자를 수정하는 작업입니다.

• 번역 및 다국어 지원 : 프로젝트를 다른 언어 사용자도 이해할 수 있도록 문서를 번역하거나 다국어 지원을 추가하는 작업입니다.

• 문서 설명 보완 : 기존 문서에 누락된 설명을 추가하거나, 예제를 보완하여 더 쉽게 이해할 수 있도록 돕는 활동입니다.

• UI/UX 개선 제안 : 사용자 경험을 향상시킬 수 있도록 레이아웃, 흐름, 디자인 등에 대한 아이디어를 제안합니다.

• 버그 수정 및 리포트 작성 : 발견한 버그를 이슈로 등록하거나, 직접 수정하는 작업입니다.

• 문서화 작업 : README, 사용법, 개발 가이드 등 문서를 체계적으로 정리하는 작업입니다.

• 기능 추가 / 수정 / 제거 : 프로젝트에 필요한 기능을 새로 구현하거나 기존 기능을 개선 또는 제거하는 작업입니다.

• 리팩토링 : 기능은 그대로 유지하되, 코드의 가독성이나 구조를 개선하는 작업입니다.

• 테스트 코드 추가 및 보완 : 기존 기능이 의도대로 동작하는지 확인할 수 있도록 테스트 코드를 작성하거나 보완하는 작업입니다.
  ...

🤔 컨트리뷰션(Contribution)을 하는 이유는 무엇일까?

👩‍💻 오픈 소스 저작자 입장

• 혼자서는 찾기 어려운 버그나 문제점을 외부 컨트리뷰터가 발견해 줄 수 있습니다.
• 실제 사용자들이 겪는 불편함이나 개선점을 더 빠르게 파악할 수 있습니다.
• 코드 품질을 높이고 기능을 다듬는 데 있어 다양한 관점의 피드백을 받을 수 있습니다.

---

🙋‍♀️ 오픈 소스 사용자/컨트리뷰터 입장

• 경험 많은 개발자들로부터 리뷰를 받으며 성장할 수 있습니다.
• 다양한 코드를 읽고 이해하면서 코드 해석 능력과 문해력이 향상됩니다.
• 내가 필요한 기능을 직접 구현하거나 제안할 수 있어, 실제 사용 환경에서 더 편리한 경험을 만들 수 있습니다.
• 기여한 내용이 반영될 때 느끼는 성취감을 느낄 수 있습니다.

---

컨트리뷰션 절차

1. 오픈 소스 프로젝트 fork

GitHub에서 기여하고 싶은 오픈 소스 프로젝트를 찾았다면,
먼저 해당 리포지토리를 자신의 GitHub 계정으로 Fork(복제)합니다.

2. Fork한 리포지토리를 내 로컬에 Clone

Fork한 리포지토리 주소를 복사해, 로컬 개발 환경에 git clone 명령어로 프로젝트를 내려받습니다.

git clone https://github.com/내아이디/복제한-레포.git

3. 코드 작성 전, 프로젝트 규칙 확인

본격적으로 작업을 시작하기 전에 다음과 같은 가이드라인을 꼭 확인해야 합니다.

• 코드 스타일 / 컨벤션

• 커밋 메시지 포맷 (ex. Conventional Commits)

• 브랜치 전략

• PR Template

• 기여 가이드(CONTRIBUTING.md)

4. 코드 구현 및 커밋

기능 추가, 수정, 버그 픽스 등 원하는 내용을 구현한 뒤 커밋(commit)합니다. 이때 커밋 메시지도 통일된 규칙을 따릅니다.

5. 내 GitHub 리포지토리로 Push

로컬에서 작업한 내용을 자신의 GitHub 리포지토리로 push합니다.

git push origin 작업한-브랜치이름

6. 원본(저작자) 리포지토리에 Pull Request 생성

GitHub에서 Fork 원본 리포지토리에 대해 Pull Request(PR)를 생성합니다. 이때 어떤 변경을 했는지 설명을 자세히 작성하면 리뷰가 수월해집니다.

7. Contributor License Agreement(CLA) 확인

일부 프로젝트는 PR을 보낼 때 CLA(기여자 라이선스 동의서)에 서명해야 합니다. 처음 PR을 보낼 때 안내가 뜨며, 보통 GitHub 계정으로 클릭 한 번이면 완료됩니다.

8. 리뷰어/메인테이너의 검토

PR은 프로젝트를 관리하는 리뷰어, 커미터, 메인테이너, 저작자가 검토합니다. 질문을 남기거나, 수정 요청을 받을 수도 있습니다. 작은 PR일 경우, 검토 없이 바로 병합될 수도 있습니다.

9. PR 병합 (merge)

승인되면 PR이 Merge(병합)되며, Pull Request closed 알림이 표시됩니다.

10. 컨트리뷰터 목록에 등록

프로젝트 README나 Contributors 리스트에 내 GitHub 계정이 등록되며 공식 컨트리뷰터가 됩니다.

---

✏️ 회고

오픈 소스에 기여하는 수많은 방법이 있다는 걸 알게 되었고, 이를 통해 작고 큰 프로젝트들에 많은 기여를 하고 싶다는 생각을 했습니다.