GitHub 온보딩
내 작업을 팀의 결과물로 합치는 방법
대상은 Git과 GitHub를 처음 사용하는 팀원입니다. 팀 안내서 our-team/handbook의 FAQ를 수정하는 예시를 사용합니다. 실행 도구와 접근 권한이 준비된 로컬 작업 환경을 전제로 합니다.
프로젝트의 기본 단위, repo
github · 소유자docs · 저장소(repo)
Repo: 파일과 변경 이력의 기본 저장 단위
입문 단계에서는 프로젝트 하나를 저장소 하나로 시작한다고 설명합니다. 프로젝트와 저장소는 항상 일대일 관계는 아닙니다.
화면은 GitHub 공식 문서 저장소 github/docs의 공개 화면입니다. 실습에서 사용하는 가상 저장소 our-team/handbook과 구분합니다. README.md는 목적과 사용 방법을 안내합니다.
프로젝트 하나를 repo 하나로 시작하면 이해하기 쉽다. 실제로는 한 프로젝트가 여러 repo를 쓰거나 한 repo에 여러 구성요소를 담기도 한다. GitHub의 ‘Projects’는 별도의 업무 추적 기능 이름이기도 하다.
로컬 작업과 원격 공유
Remote팀이 공유하는 저장소
Clone내 컴퓨터로
최초 복제
로컬에서 수정·기록 후 공유 · 웹·클라우드 작업도 가능
모든 작업이 반드시 개인 컴퓨터에서 이루어지는 것은 아니다. GitHub 웹 편집기나 클라우드 작업 환경도 있다. 여기서는 로컬과 원격의 관계를 먼저 익힌다. clone은 일반적인 ZIP 다운로드와 달리 Git 이력과 원격 연결을 포함한다.
PR: 변경사항의 병합 제안
작업 브랜치 · 변경 출발main · 반영 대상
PR 생성·추가 push는 접근 권한과 저장소 설정에 따름
실제 공개 문서 PR의 문법 수정 사례입니다. 의도하지 않은 is 한 단어의 삭제를 diff로 확인합니다. 실습 FAQ 예시와 별개의 화면입니다.
이슈는 ‘무슨 일을 할지’, PR은 ‘어떤 변경을 반영할지’를 다룬다. PR 생성에는 출발 브랜치에 변경을 올릴 수 있어야 한다. 원본 저장소에 쓰기 권한이 없으면 허용되는 경우 fork한 저장소에서 PR을 보낼 수 있다. 저장소는 PR 생성을 제한하거나 비활성화할 수도 있다.
첫 기여의 전체 흐름
약 30초의 무음 교육용 애니메이션입니다. 실제 GitHub 조작을 녹화한 영상이 아닙니다. 한국어 설명 자막을 영상에 포함해 별도 설정 없이 표시합니다. 화면의 재생 버튼으로 시작합니다. 그림 속 각 점은 기록한 버전이며, 라임 점은 FAQ 수정 기록입니다. Main이 실제로 달라지는 시점을 짚어 주세요.
완료 조건은 PR 생성과 merge 확인, 로컬 갱신까지다. 이 단계표는 앞서 설명한 개념을 적용한 교육용 실습안이다.