마젠토 2

5단계: 풀리퀘스트를 합치기(Merge your Pull Request)

마지막 단계이다. 당신의 수정내용을 모두 합할 것이다 - readme-edits 브랜치를 마스터 브랜치에 합친다.

 - 녹색의 Merge pull request 버튼을 클릭.

 - Confirm merge 버튼 클릭.

 - 수정된 것이 합쳐졌으므로  readme-edits 브랜치를 삭제한다. 브랜치 삭제버튼은 보라색 박스의  Delete branch 버튼.

축하한다!

이 튜토리얼을 통해서 당신은  깃허브에서 프로젝트를 만들고 풀리케스트를 하는 법을 배웠다.

깃허브 프로필(GitHub profile)로 가보라. 새로운 컨트리뷰션 스퀘어(contribution squares)를 볼 수 있을 것이다.

풀리퀘스트에 대해서 다 알고싶다면 GitHub Flow Guide를 참고하라. GitHub Explore를 방문해서 오픈소스 프로젝트에 참여할 수도 있다.

팁: 다른 가이드들도 둘러보고 유튜브채널도 방문하기를 권한다.

source: https://guides.github.com/activities/hello-world/#commit

4단계: 풀 리퀘스트 열기(Open a Pull Request)

자 이제 마스터에서 분리된 브랜치에서 수정된 내용을 갖고있어서 풀 리퀘스트를 오픈할 수 있다.

풀리퀘스트(Pull Request)는 깃허브(GitHub)에서 협업(collaboration)의 핵심이다. 풀리퀘스트를 오픈한다는 것은 당신이 수정한 것을 누군가가 리뷰하기를 요구하며 또 당신의 것을 그들의 브랜치에 합치기(merge)를 제안한다는 것이다. 풀리퀘스트는 양쪽 브랜치의 콘텐츠의 서로 다른 점을 보여준다. 수정내용, 추가된부분, 삭제된 부분을 녹색과 빨간색으로 보여준다.

커밋을 하면 풀리퀘스트를 오픈할 수 있고 심지어 코딩이 끝나기도 전에  토론을 시작할 수 있다.

풀리퀘스트 멧세지에있는 깃허브의 @mention system을 사용하여 특정한 사람이나 팀으로부터 피드백을 요구할 수도 있다. 

심지어 당신은 당신 자신의 저장소(repository)에서 풀리퀘스트를 오픈할 수 있고  이를 당신 자신에게 합칠 수도 있다. 이는 보다 규모있는 프로젝트를 수행하기 전에 깃허브 흐름(GitHub Flow)을 이해하는데 큰 도움이 된다.

README에 수정을 위한 풀 리퀘스트 열기(Open a Pull Request for changes to the README)

 * 스탭 1: 
  풀리퀘스트 탭을 클릭하고 풀리퀘스트 페이지에서 녹색의 New pull request 버튼을 클릭.

 * 스탭 2: 
  마스터와 비교하기위해 당신의 브랜치 readme-edits 를 선택.

 * 스탭 3:
    비교 페이지의 diffs에서 당신이 수정한 것을 확인

* 스탭 4:
    수정한 것이 커밋하는데 이상이 없다면 녹색의 큰 버튼 Create Pull Request 을 클릭

 * 스탭 5:
 당신의 풀리퀘스트에 제목과 당신의 수정사항에대한 간단한 설명을 작성.

다되었으면 Create pull request을 클릭!

 팁:당신은 코멘트와 풀리퀘스트에 emoji 나 drop images and gifs을 사용할 수 있다.

source: https://guides.github.com/activities/hello-world/#commit

3단계: 수정하고 커밋하기

브라보! 이제 readme-edits 브랜치(마스터의 카피본)의 코드뷰(readme-edits)에 있다. 뭔가를 수정해보자.

깃허브(GitHub)에서 수정된 것을 저장하는 것을 커밋(commits)라고 한다. 각각의 커밋은 관련 멧세지를 갖고있는데 이는 어떤 수정이 왜 이루어졌는지를 설명한다. 커밋멧세지(Commit messages)는 수정한 것들의 히스토리(history)를 캡쳐(capture)하기 떼문에 다른이들이 당신이 무엇을 수정했으며 또 왜 그랬는지를 알 수있다.

* 수정하고 커밋하기(Make and commit changes)
 - README.md 파일을 클릭
 - 파일뷰의 오른쪽 상단의 연필 아이콘을 클릭 -> 수정
 - 에디터에서 당신에대해 약간 작성하라.
 - 수정한 것에대한 멧세지를 작성하라.
 - Commit changes 버튼을 클릭.

 이 수정된 내용은 readme-edits 브랜치의 README 파일에 만들어 질 것이다. 이제, 이 브랜치는 마스터와 다른 콘텐츠를 갖고있다.

source: https://guides.github.com/activities/hello-world/#commit

2 단계 : 브랜치 만들기(Create a Branch)

브랜치는 한번에 저장소(repository)의 여러 다른 버전에 작업을 할 수 있는 방법이다.

최초 저장소는 최종 브랜치(definitive branch)로 간주되는 마스터(master)라는 이름의 하나의 브랜치를 갖는다. 우리는 마스터에 커밋하기 전에 시험 혹은 수정을하기위해 브랜치를 사용한다. 

마스터 브랜치로부터 하나의 브랜치를 만들어낼 때 바로 그때의 마스터의 카피본 혹은 스냅샷(snapshot)을 만든다. 만일, 브랜치에서 작업을 하는동안 누군가가 마스터 브랜치에 수정을 가했다면 그 업데이트를 가져올 수 있다.

이 다이어그램은 다음을 보여준다:

   - 마스터 브랜치.
   - feature라는(이 브랜치에서 'feature work'를 하기때문에) 새로운 브랜치.
   - 그 feature가 마스터로 합해지기 전의 과정.

다음과 같은 파일들을 저장한다.

story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt

브랜치는 깃허브저장소(GitHub repositories) 에서 유사한 목적을 달성한다.

이곳 깃허브(GitHub)에서는 개발자, 글쓴이, 그리고 디자이너들이 버그를 고치고 마스터(프로덕션, production)브랜치에서 분리해나온 피처작업(feature work)을 한다. 모든 수정이 완료되며 마스터로 합한다(merge).

* 새로운 브랜치 만들기

  - 새 저장소 hello-world로 간다.
  - branch: master 라는 파일목록 상단의 드롭다운을 클릭.
  - 브랜치명 ,readme-edits, 을 브랜치 텍스트 박스에 타이핑.
  - 파란 Create branch를 클릭하거나 엔터 키를 친다.

이제 2개의 브랜치를 갖게되었다. master 와 readme-edits. 이들은 동일하다. 하지만, 곧 바뀔 것이다. 다음은, 새로운 브랜치에 변화를 줄것이다.

source: https://guides.github.com/activities/hello-world/#branch

저장소(Repository)는 보통 하나의 프로젝트를 관리하는데 사용된다. 저장소는 폴더, 파일, 비디오, 이미지, 스프레드시트, 그리고 데이터 세트 같은 것을 포함한다- 프로젝트에 필요한 모든 것. README, 혹은 당신의 프로젝트 정보가 담긴 파일도 함께 포함시키기를 추천한다. 깃허브는 당신이 새로운 저장소를 만들때 이를 쉽게 해준다. 또한, 라이센스 파일 같은 것도 옵션으로 제공해준다.

hello-world 저장소는 당신의 아이디어, 리소스, 심지어 다른 이들과 쉐어하거나 토론할 수 있는 장소가 될 수도 있다.

* 새 저장소 만들기

  - 오른쪽 상단, 아바타 혹은 아이덴터티 아이콘. +을 클릭하고 새저장소(New repository) 를 택함.
  - 저장소에 hello-world 라고 이름을 지정.
  - 짧은 설명을 첨가
  - 'Initialize this repository with a README'를 택함.

   - 저장소생성(Create repository)을 클릭

원문: https://guides.github.com/activities/hello-world/#repository

깃허브(GitHub)는 버전콘트롤(version control)과 협업을 위한 코드 호스팅 플랫폼(code hosting platform)이다. 깃허브를 통해서 당신과 여러 사람들이 어느 곳에서든지 프로젝트를 함께 진행할 수 있다.

이 튜토리얼은 저장소(repositories), 브랜치(branches), 커밋(commits), 그리고 'pull requests' 같은 깃허브의 핵심사항을 알려줄 것이다. 당신은 Hello World 저장소를 만들고 또, 코드를 만들고 리뷰하는 방법 중 하나인 'pull requests'의 워크플로어(work flow)를 배우게될 것이다.

어떠한 코딩도 필요치 않다!

이 튜토리얼을 진행하려면 GitHub.com 계정과 인터넷이 연결되어있어야 한다. 코딩을 어떻게 하는지 알 필요도 없고 커멘드라인을 사용하는 방법을 알거나, Git(GitHub가 포함되있는 버전콘트롤 소프트웨어)를 설치 할 필요도 없다.

팁: 이 가이드를 새로운 브라우저 혹은 탭으로 열어 이 튜토리얼이 끝날때까지 함께 보라.

원문 : https://guides.github.com/activities/hello-world/