포스트

[GitHub 100일 챌린지] Day 55 - 기여할 오픈소스 프로젝트 찾기

[GitHub 100일 챌린지] Day 55 - 기여할 오픈소스 프로젝트 찾기

100일 챌린지 Day 55 - 자신에게 맞는 오픈소스 프로젝트를 찾고 첫 기여를 준비합니다.

배울 내용

  1. 초보자 친화적인 프로젝트 찾는 법
  2. GitHub 검색 기능 활용하기
  3. 첫 기여 대상 선정 기준

1. 초보자 친화적인 라벨

찾아야 할 라벨:

  • good first issue
  • beginner friendly
  • help wanted
  • documentation
  • easy
1
2
GitHub 검색:
label:"good first issue" language:JavaScript

2. GitHub 검색 활용

기본 검색

1
2
3
4
5
6
7
8
# 별이 많은 프로젝트
stars:>1000 language:Python

# 최근 활발한 프로젝트  
pushed:>2024-01-01 stars:>500

# 특정 라벨
label:"good first issue" stars:>100

고급 검색

1
2
3
4
5
# 조합 검색
language:JavaScript 
label:"good first issue"
stars:100..1000
pushed:>2024-01-01

3. 프로젝트 평가 기준

✅ 좋은 프로젝트:

  • CONTRIBUTING.md 파일 존재
  • 활발한 PR/Issue 활동
  • 친절한 커뮤니티
  • 명확한 문서화
  • CI/CD 구축

⚠️ 주의할 프로젝트:

  • 1년 이상 업데이트 없음
  • Issue/PR 방치
  • 문서 부족
  • 불친절한 응답

활동성 확인 방법

프로젝트가 살아 있는지 확인할 때는 별 개수만 보지 마세요. 별은 많지만 유지보수가 멈춘 프로젝트도 많습니다.

확인할 항목:

  • 최근 커밋이 3개월 안에 있는가?
  • Issue에 관리자가 답변하는가?
  • 최근 PR이 merge되었는가?
  • CI가 통과하고 있는가?
  • CONTRIBUTING.md가 최신 흐름과 맞는가?

검색 예시:

1
language:TypeScript label:"good first issue" pushed:>2026-01-01

관심 언어와 최근 활동 조건을 함께 넣으면 첫 기여 후보를 훨씬 빨리 좁힐 수 있습니다.


4. 추천 사이트

프로젝트 찾기:


5. 첫 기여 아이디어

쉬운 기여:

  1. 오타 수정
  2. 문서 번역
  3. 예제 코드 추가
  4. README 개선
  5. 테스트 코드 작성

중급 기여:

  1. 버그 수정
  2. 작은 기능 추가
  3. 성능 개선
  4. 코드 리팩토링

첫 기여로 피하면 좋은 작업

처음부터 너무 큰 작업을 잡으면 지치기 쉽습니다.

  • 아키텍처 전체 변경
  • 오래 논쟁 중인 기능 제안
  • 테스트가 전혀 없는 대형 버그 수정
  • maintainer가 몇 달째 답하지 않는 Issue
  • 보안 취약점 공개 수정

첫 기여의 목표는 “큰 임팩트”보다 “프로젝트의 기여 흐름을 끝까지 경험하는 것”입니다.


6. 기여 전 체크리스트

  • CONTRIBUTING.md 읽기
  • CODE_OF_CONDUCT.md 확인
  • 라이선스 확인
  • 기존 Issue/PR 검토
  • 로컬에서 빌드 성공

7. 기여 후보 기록하기

괜찮은 프로젝트를 찾았다면 바로 PR을 만들기보다 후보표를 작성합니다.

프로젝트 Issue 난이도 필요한 기술 내 상태
example/docs README 오타 수정 낮음 Markdown 바로 가능
example/api 예외 처리 개선 중간 Python, pytest 테스트 확인 필요

후보를 3개 정도 모아두면 하나가 이미 해결되었거나 답변이 늦어도 다음 선택지가 있습니다.

Issue에 댓글을 달 때는 짧고 예의 있게 남깁니다.

1
2
3
안녕하세요. 이 이슈를 처음 기여로 작업해보고 싶습니다.
제가 이해한 작업 범위는 README의 설치 단계 설명을 보완하는 것입니다.
진행해도 괜찮을까요?

정리

완료 체크:

  • good first issue 라벨로 프로젝트를 검색할 수 있다
  • 프로젝트 평가 기준을 적용할 수 있다
  • 첫 기여 아이디어를 3가지 이상 떠올릴 수 있다
  • 기여 후보를 표로 정리하고 maintainer에게 예의 있게 문의할 수 있다

핵심 요약:

  • label:"good first issue" 검색 활용
  • 활발하고 친절한 프로젝트 선택
  • 문서 수정부터 시작하기
  • 첫 기여는 작고 명확한 작업이 좋다

다음: Day 56 - Pull Request 개념


이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.