입문자를 위한 GitHub: GitHub 이슈
GitHub Issues는 버그·작업·아이디어를 기록하고 협업하는 단위이며, Projects는 이를 시각적으로 구성해 우선순위와 진행 상황을 관리하는 도구다. 두 기능을 함께 사용하면 업무를 빠짐없이 추적하고 팀의 진행 상황을 공유할 수 있다. 글은 이슈 생성부터 Kanban 프로젝트 구성, 사용자 지정 필드·차트·워크플로 설정까지 초보자가 따라 할 수 있는 기본 절차를 설명한다. ## GitHub Issues와 Projects가 필요한 이유 - **Issues**는 버그, 신규 기능, 작업, 아이디어 등 처리해야 할 항목을 공유 공간에 기록한다. - **Projects**는 여러 이슈를 하나의 대시보드에 모아 큰 목표를 작은 작업으로 나누고 관리한다. - 두 기능을 결합하면 다음을 수행할 수 있다. - 업무 우선순위 설정 - 담당자와 진행 상태 공유 - 관련 작업 간 연결 - 팀 전체의 목표와 진행 상황 정렬 ## 첫 번째 Issue 만들기 샘플 저장소나 자신의 저장소에서 다음 순서로 이슈를 생성한다. - **Issues** 탭에서 **New issue**를 선택한다. - 제목에는 처리할 내용을 명확하게 작성한다. - 설명에는 수정하거나 추가해야 할 동작, 기대 결과 등 필요한 정보를 구체적으로 적는다. - 다음 항목을 설정할 수 있다. - **Assignee**: 담당자 지정 - **Labels**: 버그, 기능, 문서 등 분류 - **Type**: 버그나 작업 등의 이슈 유형 지정 - **Projects**: 특정 프로젝트에 이슈 추가 - **Milestone**: 목표 버전이나 일정 단위에 연결 - **Create**를 클릭해 이슈를 생성한다. ## 이슈를 활용한 협업 - 팀원은 이슈에 댓글을 작성해 논의하거나 진행 상황을 공유할 수 있다. - 댓글 입력창에서 `#이슈번호`를 입력하면 다른 이슈와 클릭 가능한 링크로 연결된다. - 관련 작업을 서로 연결하면 의존 관계나 후속 작업을 추적하기 쉽다. - 작업이 완료되면 이슈를 닫아 팀에 해결 사실을 알린다. ## GitHub Project 만들기 Projects는 이슈를 시각적인 작업 보드로 관리하는 기능이다. - 저장소의 **Projects** 탭에서 **New project**를 클릭한다. - 템플릿에서 **Kanban**을 선택한다. - 프로젝트 이름을 입력한다. - 필요하지 않다면 **Bulk import items** 옵션을 해제한다. - **Create project**를 선택한다. - 생성된 프로젝트에는 기본 열이 자동으로 추가되며, 팀의 업무 방식에 맞게 수정할 수 있다. - 프로젝트에는 여러 보기 탭이 제공되므로 보드 형태 등을 전환해 확인할 수 있다. ## 프로젝트 설정과 사용자 지정 프로젝트 우측 상단의 메뉴에서 **Settings**를 열면 다음을 관리할 수 있다. - 프로젝트 접근 권한 - 사용자 지정 필드 생성 및 기존 필드 수정 - 프로젝트 이름과 설명 - README 추가 - 프로젝트 복제 - 프로젝트 공개 범위 - 프로젝트 보드의 전반적인 구성 ## 차트와 인사이트 - **Insights** 메뉴에서 프로젝트 데이터를 바탕으로 차트를 확인하거나 새로 만들 수 있다. - **Configure** 버튼을 사용해 차트의 레이아웃과 표시 방식을 변경할 수 있다. - 차트를 활용하면 작업량, 상태 분포, 진행 추세 등을 시각적으로 파악할 수 있다. ## 워크플로 자동화 **Workflows** 메뉴에서는 프로젝트 항목의 상태를 이벤트에 따라 자동으로 변경하는 기본 워크플로를 설정할 수 있다. - 새 항목이 프로젝트에 추가되면 상태를 `todo`로 지정 - 프로젝트에서 이슈 상태가 변경되면 이슈를 자동으로 닫기 - 이슈가 닫히면 프로젝트 상태를 `Done`으로 변경 이러한 자동화를 사용하면 수동 상태 업데이트를 줄이고 프로젝트 보드의 정보가 실제 진행 상황을 더 잘 반영하도록 만들 수 있다. ## 프로젝트 상태 업데이트 - 프로젝트 화면 상단의 **Add status update**를 선택하면 프로젝트의 건강 상태와 진행 상황을 보고할 수 있다. - 정기적인 상태 업데이트를 남기면 팀원이 현재 진척도와 위험 요소를 쉽게 확인할 수 있다. ## 실용적인 활용 추천 작은 팀이나 개인 프로젝트라도 먼저 이슈를 명확한 제목과 설명으로 작성하고, 담당자·라벨·마일스톤을 일관되게 지정하는 것이 좋다. 이후 Kanban 프로젝트에 이슈를 연결하고 `todo`·진행 중·`Done` 같은 상태와 자동 워크플로를 설정하면 업무 흐름을 간단하고 지속적으로 관리할 수 있다.
원문 읽기(새 탭에서 열림)