18-6 contribution

18-6 contribution practical

오픈소스 프로젝트 기여 방법

---

for challengers

유지보수나 안정화가 되어있는 프로젝트는, 팔로우업도 힘들고, 참여 가능 여부도 확신할 수 없음.
React처럼 자주 사용해봤던 라이브러리의 서드파티 기능 같은 난이도를 권장. // 관심있거나, 사용 중인 라이브러리 추천

추천 라이브러리

• react-icons (https://github.com/react-icons/react-icons)
• react-datapicker (https://github.com/Hacker0x01/react-datepicker)
• react-storybook (https://github.com/storybookjs/storybook)
  등

1. 프로젝트의 readme.md 같은 문서확인
   • 설치법, 사용법, 수정/변경 사항 등
   • 위 내용 이외에도 라이선스, Contributing (기여)에 대해 설명(절차)을 참고할 것

2. Fork
   • 기여 하고싶은 프로젝트를 Fork하여 본인의 레포지토리로 복사

3. Clone
   • 본인의 레포지토리로 복사해온 프로젝트를 로컬(git)로 Clone하여 가져오기

4. Development
   • 개발관련 설명(필요 확장프로그램 등) 확인
     e.g. yarn 이 필요하고 ~~ 이렇게 해라

    yarn 
    
    cd packages/react-icons
    yarn fetch #fetch icon sources
    yarn build

   yarn : npm 같은 자바스크립트 패키지 매니저, 라이브러리(패키지)를 설치, 관리할 수 있게 해주는 도구

    
   yarn 관련 주요 명령어
    

   명령어	설명
   yarn add <패키지 명>	패키지 설치
   yarn add <패키지 명> --dev	개발 의존성으로 설치
   yarn remove <패키지 명>	패키지 제거
   yarn install	프로젝트 의존성 설치 (package.json 기반)
   yarn upgrade	전체 의존성 업데이트

5. confirm
   • react-icons 를 예로, 아이콘을 추가하기 전에 Discussion 탭에서, 목록을 확인 해보거나, 'Discussion(논의)'를 통해 추가여부를 결정하거나, 아이디어 공유 등 소통을 통해 프로젝트 진행에 도움되는 것들을 확인 가능.

6. Contribution

   PR로 요청을 보내거나 Issue를 등록하는 것 모두 기여에 해당합니다.

   대략적인 흐름

   1. Issue -> 2. Discussion -> 3. Task -> 4. Pull Request -> 5. Review or Merge

   	Pull Request	Issue
   목적	코드 병합	문제 제보, 아이디어 제안
   코드	있음	없음
   등록 시기	코드 작업 완료 후	작업 전 or 중간
   예시	기능 추가 PR, 오류 수정 PR	다크모드 추가 제안, 클릭 시 반응없음