[73일차]첫 오픈 소스 기여 & 프로젝트 발굴하기

1. 실전 시뮬레이션: first-contributions

오픈 소스 기여를 주저하게 만드는 가장 큰 이유는 "내가 뭔가 잘못해서 프로젝트를 망치지 않을까?"라는 두려움이다. first-contributions 프로젝트는 이러한 두려움을 없애기 위해 만들어진 샌드박스(Sandbox) 저장소이다. 이 프로젝트는 오직 '기여 연습'만을 위해 제공되므로, 편안한 마음으로 실습할 수 있다.

• 한국어 가이드 경로: first-contributions/translations/README.ko.md

---

1-1. 기여 프로세스 (CLI 환경 기준)

가장 정석적인 방법은 Git 명령어를 사용하는 것이다. 이 흐름은 실제 오픈 소스 기여와 100% 동일하며, CLI(Command Line Interface)를 통해 작업하는 방식이다.

1. Fork (포크)
   타겟 저장소 우측 상단의 Fork 버튼을 눌러 내 계정으로 저장소를 복사해온다.

2. Clone (복제)
   내 컴퓨터(로컬)로 코드를 가져온다.

   git clone https://github.com/<내-아이디>/first-contributions.git

3. Branch (브랜치 생성)
   작업을 분리하기 위해 새로운 브랜치를 생성한다.

   git switch -c <브랜치-이름>
   # 또는
   git checkout -b <브랜치-이름>

4. Edit (수정)
   Contributors.md 파일을 열어 자신의 GitHub 아이디와 이름을 목록에 추가한다.

5. Commit & Push
   변경 사항을 저장하고 원격 저장소(내 GitHub)로 보낸다.

   git add Contributors.md
   git commit -m "Add <내-이름> to Contributors list"
   git push origin <브랜치-이름>

6. Pull Request (PR)
   GitHub 페이지에서 Compare & pull request 버튼을 눌러 원본 저장소에 내 변경 사항을 반영해달라고 요청한다.

---

1-2. 기여 프로세스 (Web UI 환경)

Git 설치가 어렵거나 로컬 환경 설정이 안 된 경우, GitHub 웹사이트 기능만 사용하여 기여할 수 있다.

1. Fork 진행
   타겟 저장소 우측 상단의 Fork 버튼 클릭.

2. Contributors.md 파일 수정
   복사된 내 저장소에서 Contributors.md 파일을 찾아 연필 아이콘(Edit)을 클릭.

3. 웹 에디터 수정
   웹 에디터에서 자신의 GitHub 아이디와 이름을 추가.

4. Commit 생성 및 브랜치 선택
   하단의 'Commit changes' 박스에서 'Create a new branch for this commit and start a pull request' 옵션을 선택하고 커밋.

5. Pull Request (PR) 제출
   생성된 PR 페이지에서 내용을 작성한 후 제출한다.

---

2. 기여할 오픈 소스 프로젝트 찾기

기여 방법을 익혔더라도 "어떤 프로젝트의 무엇을 고쳐야 할지" 막막할 수 있다. GitHub에서는 검색 기능과 라벨(Label) 필터링을 활용하여 기여할 프로젝트를 쉽게 찾을 수 있다.

---

2-1. 핵심 라벨 (Labels)

오픈 소스 관리자는 초보자나 외부 기여자를 환영한다는 의미로 특정 라벨(Labels)을 붙여둔다. 아래는 대표적인 핵심 라벨의 의미이다.

라벨 이름	의미
good first issue	초보자가 해결하기 좋은 난이도의 이슈. 가장 추천하는 라벨이다.
help wanted	메인테이너의 손이 부족하여 외부 도움이 필요한 이슈.
documentation	코드 수정이 아닌, 문서(번역, 오타 수정 등) 작업이 필요한 이슈.
first-timers-only	오직 처음 기여하는 사람만을 위한 이슈.
low-hanging-fruit	쉽게 딸 수 있는 과일이라는 의미로, 해결하기 쉬운 문제를 가리킨다.

---

2-2. 검색 문법 (Search Syntax) 활용

GitHub 상단 검색창에서 검색 문법을 활용하여 자신에게 적합한 이슈를 빠르게 찾을 수 있다.

• 기본 문법:

  label:"<라벨명>" language:<언어> state:open

검색 예시

1. 자바스크립트 프로젝트 중 초보자용 이슈 찾기:

   label:"good first issue" language:javascript state:open

2. 리액트 관련 도움 요청 이슈 찾기:

   label:"help wanted" topic:react state:open

3. 담당자가 배정되지 않은 이슈 찾기:
   (중요: 이미 누군가 작업 중인 이슈를 피할 수 있다.)

   label:"good first issue" no:assignee state:open

---

기여를 위한 팁

1. 작은 기여라도 가치 있다
   오탈자 수정, 번역 기여 등 사소한 작업조차 프로젝트 유지보수에 큰 도움이 된다.

2. CONTRIBUTING.md 확인
   기여 규칙(CONTRIBUTING.md)을 먼저 읽은 후, 제출 절차를 꼭 준수해야 한다.

3. 라벨 & 검색 필터 활용
   자신의 기술 수준에 맞는 작업을 찾는 것이 기여 첫 단계를 수월하게 이끈다.