OSS - 09_GitHub로 협업하기

GitHub의 협업 도구

이슈 트래커(Issue Tracker): 버그 보고, 기능 개선 건의, 그 외 프로젝트 관련 주제(이슈) 등 등록할 수 있는 일종의 게시판

담당자, 알림, 라벨, 커밋 래퍼런스, 마일스톤 등 일반 게시판과는 다른 항목들 존재

이슈 등록은 커밋 내역 참조 시 의미 있음

이슈의 제목과 내용(커밋의 체크섬 값 복사) 입력

 

위키(Wiki)

위키백과처럼 특정 주제나 단어 등에 대한 정보를 담아둔 개별 페이지를 작성 

첫 위키 문서 작성 필요

위키 문서 작성 시 AsciiDoc, Creole 등 여러 문법 사용 가능

아직 생성되지 않은 링크 추가 시 빨간색으로 표시됨 / 클릭 시 새 문서 생성 화면으로 연결

 

풀 리퀘스트(Pull Request)

일반적인 병합 - 브랜치 사이의 변경 내용 합하는 것

풀 리퀘스트는 원본 저장소와 포크한 저장소 사이를 비교 후 변경 내역 병합 요청하는 것

 

프로젝트 위한 협업 준비 규칙

커밋 단위 - 내용이 여러 개 -> 분리해서 커밋해야 함 / 커밋 내용 최소 단위로 유지

커밋 메시지 작성 규칙 - 짧고 명확 / 왜 커밋했는지, 어떤 문제가 있는지, 이슈의 하이퍼링크 포함

브랜치 이름 작성 규칙 - 카테고리 이름을 접두어로 사용하면서 그 뒤에 브랜치 이름 붙임

태그와 버전 이름 작성 규칙 - x: 호환 되지 않는 변경 발생 / y: 호환 가능, 새 기능 추가 시 / z: 호환 가능, 버그 수정 등

 

프로젝트 유형별 협업 흐름

Git를 이용한 협업은 브랜치 생성 규칙을 공유하는 것