-
Notifications
You must be signed in to change notification settings - Fork 4
Home
GitHub 커뮤니티 스탠다드와 이를 활용한 협업 시스템의 핵심은 투명한 의사소통, 체계적인 워크플로우 관리, 안전한 협업 환경 조성에 있다. 주요 내용은 다음과 같다.
- GitHub 커뮤니티의 목적은 소프트웨어 프로젝트 협업이며, 이를 위해 상대방을 존중하고 열린 태도를 유지하는 것이 기본 전제다.
- 비판은 개인이 아닌 아이디어와 코드에 한정하며, 사려 깊고 건설적인 방식으로 의견을 제시해야 한다.
- 글로벌 커뮤니티 특성을 고려해 다양한 배경과 관점을 존중하고 공감하는 태도를 유지한다.
효율적인 협업을 위해 저장소 내에 다음 문서를 갖추는 것이 권장된다.
-
README.md 프로젝트 목적, 기능, 설치 방법, 사용법, 디렉터리 구조 등을 설명해 신규 참여자의 진입 장벽을 낮춘다.
-
CONTRIBUTING.md 기여 절차, 규칙, 기여 유형을 명시해 내부·외부 기여자가 동일한 기준으로 참여하도록 한다.
-
CODE_OF_CONDUCT.md 참여자 행동 기준을 정의해 일관되고 우호적인 협업 문화를 유지한다.
-
SECURITY.md 보안 취약점 제보 절차를 명시해 프로젝트 안정성을 확보한다.
-
브랜치 전략 Git-flow 또는 GitHub-flow 등을 적용해 feature, fix, hotfix 등 목적별 브랜치를 분리 관리함으로써 충돌과 리스크를 줄인다.
-
이슈 관리 작업 단위를 이슈로 관리하고 담당자, 라벨, 마일스톤을 활용해 진행 상황을 투명하게 공유한다. 이슈 템플릿 사용을 권장한다.
-
풀 리퀘스트(PR) 변경 사항을 병합 전 공유하고 코드 리뷰를 거치는 절차다. PR 본문에는 작업 배경, 변경 내용, 검증 방법을 명확히 기록한다.
- 코드 리뷰는 오류 탐지뿐 아니라 지식 공유와 코드 품질 향상을 목적으로 한다.
- 단순 지적이 아닌 협업 중심의 피드백을 지향하며, 구체적인 개선 방향을 함께 제시한다.
- 승인 후 병합을 원칙으로 하며, 병합 완료된 작업 브랜치는 삭제해 저장소를 정리한다.
-
브랜치 보호 규칙 메인 브랜치 직접 푸시를 제한하고, 리뷰 승인 및 테스트 통과를 병합 조건으로 설정해 안정성을 확보한다.
-
권한 레벨 관리 Owner, Member, Outside Collaborator 등 역할별 최소 권한 원칙을 적용해 접근을 통제한다.
-
중재 도구 활용 부적절한 댓글 관리, 대화 잠금, 사용자 차단 등을 통해 커뮤니티를 보호한다.