GitHub Organization 만들기 A to Z 🚀

안녕하세요.
오늘은 GitHub Organization을 만들고 관리하는 방법에 대해 정리해보려고 합니다.

개인 레포를 쓰다 보면
스터디나 팀 프로젝트에서는 뭔가 애매해지는 순간이 오는데요.
이럴 때 쓰는 게 GitHub Organization입니다.

이 글에서는
Organization을 왜 쓰는지 간단히 짚고,
이슈 템플릿으로 리뷰가 가능한 구조를 만들고,
외부에서 봐도 이해되는 Organization README까지 설정하는 걸 목표로 합니다.

목표는
이슈 템플릿을 사용해서 리뷰할 수 있도록 만드는 것,
그리고 Organization 메인 페이지가 비어 보이지 않게 README를 작성하는 것까지입니다

먼저 GitHub Organization이 뭔지부터 짚고 가면 좋을 것 같아요.

GitHub Organization은
개인 계정이 아니라 팀 단위로 레포지토리와 멤버를 관리하기 위한 공간입니다.

개인 레포와 가장 큰 차이는
레포의 소유 주체가 개인이 아니라 조직이라는 점이고,
멤버마다 역할과 권한을 나눠서 관리할 수 있다는 점이에요. 잔디가... 안 쌓여요

스터디나 세션, 팀 프로젝트처럼
여러 명이 같은 규칙으로 작업해야 하는 경우에는
개인 계정보다는 Organization을 쓰는 게 훨씬 편합니다.

---

1단계 Organization 생성하기

GitHub 우측 상단 프로필 메뉴를 클릭하고
Your organizations를 누른 뒤
New organization을 선택하면 됩니다.

Free 플랜으로 시작해도
이슈, PR, 템플릿, 멤버 관리까지 대부분의 기능은 충분히 사용할 수 있어요.

이때 중요한 포인트는 Organization도 하나의 계정처럼 동작한다는 점입니다.
레포는 전부 Organization 소유가 되고
개인 계정은 Owner나 Member로 참여하는 구조입니다.

중간에 많이 헷갈리는 부분이 하나 있는데용...
설정 화면이 어디 있는지입니다.
Organization 페이지로 들어가면 우측 상단에 Settings 메뉴가 있고 여기서 멤버 초대, 권한 설정, 레포 생성 권한 같은 것들을 관리합니다.
이 메뉴가 안 보인다면 대부분 Owner 권한이 아니라서 그렇습니다.

2단계 Organization 프로필 설정하기

Organization 프로필을 설정하려면:

Organization 메인 페이지에 설명을 띄우려면
.github라는 이름의 레포를 하나 만들어야 합니다.

구조는 단순합니다!
.github 레포를 만들고
그 안에 profile 폴더를 만든 뒤
profile 안에 README.md를 작성하면 됩니다.

여기서 레포 이름이 정말 중요합니다.
반드시 .github여야 하고
README 경로도 profile/README.md를 지켜야 합니다.

!!! 이 조건을 만족해야 Organization 메인 페이지에 README가 노출됩니다.
Organization README에는 보통 이런 내용을 씁니다.

• 이 조직이 무엇을 하는지
• 어떤 목적을 가지고 있는지
• 어떤 레포들이 있는지
• 어떻게 참여하고 활동하는지

너무 꾸미려고 하기보다는
처음 들어온 사람이
아 여기 뭐 하는 곳인지 알겠다 정도만 이해하면 충분합니다.

3단계 이슈 템플릿 설정하기

이슈 템플릿은 협업할 때 체감 차이가 제일 큰 부분입니다.

Organization에 .github 레포를 만들어두면
이슈 템플릿을 조직 전체에서 공통으로 사용할 수 있습니다.

구조는 이렇게 만듭니다.

.github 폴더 아래에
ISSUE_TEMPLATE 폴더를 만들고
그 안에 md 파일을 하나 생성합니다.

.github/
└── ISSUE_TEMPLATE/
    └── review-task.md

예를 들어
주차별 학습 리뷰용 템플릿을 만든다면 리뷰 요약
이해한 개념 어려웠던 부분 다음 주 목표
같은 항목을 미리 써두는 식입니다.

이렇게 해두면 모든 멤버가 같은 형식으로 이슈를 작성하게 되고, 리뷰 기준도 자연스럽게 통일됩니다.

템플릿 예시

---
name: "주차별 학습 리뷰"
about: "학습 내용 정리 템플릿"
title: "[Week N] 제목"
labels: "review"---

4단계 멤버 초대와 권한 관리

멤버 초대는 상단바의에 들어가서
People 메뉴에서 진행합니다.

권한은 크게 Owner와 Member로 나뉘는데
Owner는 모든 설정을 건드릴 수 있고
Member는 일반적인 작업만 할 수 있습니다.

운영하는 입장에서는
Owner 권한은 최소한으로 두는 게 좋습니다.
스터디든 프로젝트든
실수로 설정이 바뀌는 걸 막는 데 도움이 됩니다.

---

자주 생기는 문제도 간단히 정리해보면

Organization README가 안 보이는 경우는
.github 레포 이름이나
profile/README.md 경로가 틀린 경우가 대부분입니다.

이슈 템플릿이 적용되지 않는 경우는
폴더 이름 오타나
YAML 문법 오류 때문에 생기는 경우가 많습니다.

설정 메뉴가 안 보인다면
Owner 권한인지 한 번 확인해보면 됩니다.

이 정도까지 설정해두면
Organization은 그냥 레포 모음이 아니라
협업 방식이 정리된 공간이 됩니다.

이슈 템플릿은 규칙 역할을 하고
README는 컨텍스트를 설명해주고
권한 관리는 운영 안정성을 만들어줍니다.

실제로 만든 Organization은 여기입니다.
https://github.com/khuda-deepdive-session

더 보완하고 싶으면
스터디용 README 템플릿을 더 구체화하거나
리뷰용 이슈 템플릿을 상황별로 나누는 것도 좋습니다.
https://github.com/khuda-deepdive-session
만든 ORGANIZATION 입니당