Skip to content

Latest commit

 

History

History
138 lines (85 loc) · 9.15 KB

README.ko.md

File metadata and controls

138 lines (85 loc) · 9.15 KB

Open Source Love License: MIT Open Source Helpers

첫 기여

어렵습니다. 무엇을 하든 누구에게나 처음은 어렵게 느껴집니다. 특히 협업을 할 때 실수를 하기라도 하면 마음이 편치 않습니다. 그래서 저희는 새로운 오픈소스 기여자들이 첫 기여를 하고 그것을 익히는 과정을 단순화하고자 했습니다.

관련된 글을 읽거나 튜토리얼을 보는 것도 물론 도움이 되지만, 본인이 직접 해보는 것보다 나은게 있을까요? 이 프로젝트의 목표는 초보자분들도 첫 오픈소스 기여를 할 수 있도록 아주 쉽게 안내하는 것입니다. 첫 기여를 하고 싶으시다면 아래의 설명을 따라주세요.

이 저장소 포크하기

가장 먼저, Git이 없으시다면 설치해주세요.

저장소 포크하기

이 페이지의 상단에 있는 Fork 버튼을 클릭하여 이 저장소를 포크하세요. 그러면 본인의 깃헙 계정에 이 저장소의 복제본이 생성될 겁니다.

저장소 클론하기

이 저장소 복제하기

이제 이 저장소를 자신의 기기에 클론합니다. Clone or download 버튼을 클릭하고 클립보드로 복사 아이콘을 클릭합니다.

터미널을 열고 다음 Git 명령을 실행합니다:

git clone "방금 복사한 URL"

위에 (따옴표를 제외한) "방금 복사한 URL"는 이 저장소의 URL입니다. URL은 이전 단계에서 찾을 수 있습니다.

URL 을 클립보드로 복사

예시:

git clone https://github.com/this-is-you/first-contributions.git

예시의 this-is-you는 본인 깃헙 계정으로 바꾸어주세요. 이 명령어는 깃헙의 first-contributions 저장소의 내용을 로컬 컴퓨터에 복사합니다.

브랜치 생성하기

(아직 저장소 디렉토리가 아니라면) 아래의 명령어를 입력하여 조금 전에 컴퓨터에 복사한 저장소 디렉토리로 이동합니다.

cd first-contributions

그리고 git checkout 명령어을 입력하여 브랜치를 생성합니다.

git checkout -b <add-your-name>

예시:

git checkout -b add-alonzo-church

(브랜치의 이름에 꼭 add가 들어가지 않아도 됩니다. 하지만 이 브랜치의 목적은 당신의 이름을 리스트에 추가하는 것이기 때문에 이름에 add를 포함하는 것이 합리적입니다.)

필요한 변경사항을 작성하고 커밋하기

이제 텍스트 편집기에서 Contributors.md 파일을 열고 본인의 이름을 아래와 같이 추가해주세요. 이때 맨 처음이나 맨 끝을 제외한 중간에 마음에 드는 곳에 추가하시면 됩니다. 그리고 파일을 저장(ctrl + s)하세요.

git status

프로젝트 디렉터리에서 git status 명령을 실행하면 변경사항을 볼 수 있습니다.

변경사항을 아래 git add 명령어를 입력하여 추가합니다.

git add Contributors.md

이제 아래 git commit 명령어로 변경사항을 커밋합니다.

git commit -m "Add <Your-name> to Contributors list"

<Your-name>을 본인 이름으로 바꾸세요. 예시:

git commit -m "Add alonzo-church to Contributors list"

변경사항을 깃헙에 푸시하기

git push 명령어로 변경사항을 푸시합니다.

git push origin <add-your-name>

위의 <add-your-name> 부분을 좀전에 생성한 브랜치 이름으로 바꾸세요.

예시:

git push origin add-alonzo-church

검토를 위해 변경사항을 제출하기

이제 본인의 깃헙 저장소로 이동하면 Compare & pull request 버튼이 보일 것 입니다. 버튼을 클릭하세요.

풀 요청
생성하기

이제 풀 요청(Pull Request)을 제출합니다.

풀 요청 제출하기

이제 여러분의 변경사항을 담당자가 확인한 후에 마스터 브랜치에 머지 하게 되면 알림 메일을 받으실겁니다.

첫 기여, 그리고 그 후

축하합니다! 앞으로 기여자로써 자주 사용하게될 기본 워크플로우, 포크(fork) -> 클론(clone) -> 수정(edit) -> 풀 요청(pull request), 를 완수하셨습니다!

첫 기여에 대한 소식을 친구들 및 팔로워에게 웹 앱을 통해 공유해보세요.

그리고 도움이 필요하거나 질문이 있다면 저희의 slack 에서 요청해보세요. → slack 팀 가입하기

이제 다른 프로젝트에도 기여해보세요! 지금 바로 시작할 수 있는 난이도가 낮은 이슈들로 가득찬 목록이 있습니다. 웹앱의 프로젝트 목록에서 확인해보세요!

다른 도구들에 관한 튜토리얼

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code Atlassian Sourcetree IntelliJ IDEA