오픈소스 컨트리뷰션 참여방법

by jullee posted Dec 04, 2020
?

단축키

Prev이전 문서

Next다음 문서

ESC닫기

크게 작게 위로 아래로 댓글로 가기 인쇄

컨트리뷰션이란?

 

 컨트리뷰션은 오픈소스 프로젝트에 참여하고 기여하는 모든 활동을 의미합니다. 전 세계 사람들이 다양한 컨트리뷰션 활동을 통해 오픈소스를 발전시키고 있습니다.

 
 

컨트리뷰션의 유형

 

컨트리뷰션에 대해 일반적으로 오해하는 것이 바로 '소스 코드 수정'만 컨트리뷰션에 해당한다는 것입니다. 소스 코드 수정 이외에 다양한 방법으로 누구든 컨트리뷰션에 첫 발을 디딜 수 있습니다. 사용하던 오픈소스에서 버그를 발견했을 때 버그를 알리는 것만으로도 컨트리뷰션을 시작할 수 있습니다.

 

소스 코드 수정 이외에 어떤 유형의 컨트리뷰션이 있는지 알아보겠습니다.

 

버그 리포트

사용하면서 발생한 버그를 깃헙 이슈로 올리는 일도 컨트리뷰션입니다.

 

아래는 하모니카 깃헙의 nimf프로젝트의 사례입니다. 

 

 

* 참여방법 *

1)  https://github.com/hamonikr 하모니카 깃헙 프로젝트중 참여하고싶은 프로젝트에 이슈를 리포트 해주시면 됩니다.

 

1. 깃헙 프로젝트 내에 이슈 탭에서 [new issue] 선택

 

 

 

 

2. 이슈 종류 중 버그리포트 [Get Started] 선택

 

 

 

3. 형식에 맞게 작성 후에 [submit new issue] 을 클릭해주세요

 



 

2) 어느 프로젝트에서 발생하는 버그인지 모르겠지만  하모니카 OS를 사용하면서 생겼다면 

https://hamonikr.org/used_hamonikr [하모니카 사용기 게시판] 에 버그의 내용도 같이 올려주시면 됩니다.

 

** 단 작성시에 아래의 형식으로 작성해주세요

1. 제목 형식 -> “[bug] 버그 현상”

2. 버그 재현과정

3. 예상결과

4. 스크린샷

5. 자신의 PC환경 (OS/브라우저/버전)

 

 

다양한 의견 제공

단순히 프로젝트에 관한 의견을 제시하는 것도 컨트리뷰션입니다.

 

* 참여방법 *

1)   https://github.com/hamonikr 하모니카 깃헙 프로젝트중 참여하고싶은 프로젝트에 이슈를 리포트 해주시면 됩니다.

 

버그 리포트와 동일하게 이슈를 생성하되 이슈 유형을 “기능 제안” 으로 선택해서 자유롭게 작성해주시면 됩니다. 


 

2) 하모니카 OS를 사용하면서 이런 기능이 있었으면 혹은 개선되었으면 하는 사항에 대해서도 https://hamonikr.org/used_hamonikr [하모니카 사용기 게시판] 에 자유롭게 올려주시면 됩니다.

 

발견한 오타 수정

소스 코드나 문서에 있는 오타를 수정하는 일도 컨트리뷰션입니다.

 

* 참여방법 *

1)   https://github.com/hamonikr 하모니카 깃헙 프로젝트중 오타가 있는 프로젝트를 개인 레파지토리로 fork를 떠주시고 수정사항을 PR(Pull Request)로 보내주세요.  

 

** PR보내는 방법 

1. 수정하고자하는 프로젝트가 있는 원저장소를 fork를 뜬다

2. 내 저장소로 fork가 떠진 것을 확인(원저장소 jullee96 -> 내저장소 melik210 )

3. 내저장소에서 수정사항을 커밋한다. (커밋 코멘트에 변경사항 적시)


 

4. Pull requests 탭에가서 [New pull request]를 누른다

 

5. pr이 가는 base 레파지토리와 보내는 레파지토리를 확인하고 [Create pull request]를 누른다

 

6. base 레파지토리의 Pull requests 탭에 생성한 PR이 등록된다.

 

 

2) 하모니카 OS를 사용하면서 오타를 발견하셨는데 어느 프로젝트인지 모르시겠다면 https://hamonikr.org/used_hamonikr [하모니카 사용기 게시판] 에 아래의 형식으로 올려주시면 됩니다.

 

1. 제목 형식 -> “[오타수정] 오타 발생 내용”

2. 오타 발생화면 캡처 및 설명

 

번역하기

프로젝트에 필요한 문서를 번역하는 일도 컨트리뷰션입니다.

 

* 참여방법 *

1) 프로젝트 깃허브에서 제공하는 번역 기여방법을 확인합니다.

2) 번역을 위해 po 파일을 수정해서 PR 하거나, 프로젝트의 번역 기여 가이드라인을 따릅니다.

 

가이드라인 문서 작성

튜토리얼과 같은 가이드 문서를 작성하는 일도 컨트리뷰션입니다.

 

* 참여방법 *

1) 하모니카 프로젝트 가이드 문서를 작성하시는 경우 오타수정 방식과 동일하게 fork를 뜬다음 PR을 보내주시면 됩니다.

 

2) 그 외에 하모니카 OS가이드 문서라면 https://hamonikr.org/used_hamonikr [하모니카 사용기 게시판]에 작업하신 내용을 아래의 형식으로 올려주시면 됩니다.

1. 제목 형식 -> “[하모니카 OS 가이드] 가이드하는 내용”

2. 이미지 및 내용 작성

3. (선택) pdf 형식으로 동일 내용의 파일 첨부

 

디자인 작업

로고와 같은 디자인 요소를 제작하는 일도 컨트리뷰션입니다.

 

* 참여방법 *

https://hamonikr.org/used_hamonikr [하모니카 사용기 게시판]에 작업하신 디자인 작업에 대해서 올려주시면 됩니다.

 

사용 경험 공유

앞에서 설명한 유형 외에도 단지 사용해본 감상을 남겨주시는 것도 컨트리뷰션입니다.

 

커뮤니티에 여러분의 사용기를 공유해주세요.