[공지] GitHub 협업 컨벤션 및 운영 규칙

[yeverycode]

📢 [공지] GitHub 협업 컨벤션 및 운영 규칙

안녕하세요.
본 Repository는 2026 오픈소스프로그래밍 프로젝트의 기술 논의, 의사결정 기록, 진행 상황 공유를 위한 Discussion 공간입니다.

프로젝트 관련 공지사항, 아이디어 제안, 질문, 회의 내용 및 결과 공유는 Discussion을 활용하여 기록합니다.

---

📌 Discussion 활용 방법

📢 공지사항

• 프로젝트 운영 규칙
• 일정 변경 안내
• 회의 일정 공지
• 중요 의사결정 공유

💬 자유 토론

• 프로젝트 관련 자유로운 의견 공유
• 개발 진행 상황 논의
• 기능 범위 조정 논의

💡 아이디어 제안

• 기능 개선 제안
• 기술 스택 관련 아이디어
• 향후 확장 기능 논의

🗳️ 투표

• 기술 스택 선정
• 프로젝트 의사결정
• 기능 우선순위 결정

🙏 질문 및 답변

• 개발 과정에서 발생한 질문
• 데이터셋 및 모델 관련 질문
• 협업 과정에서의 문의

🙌 결과 공유

• 개발 결과 공유
• 학습 결과 공유
• 시연 영상 및 화면 공유

---

🌱 GitHub 협업 규칙

브랜치 규칙

브랜치 이름

feat/이슈번호-기능명
fix/이슈번호-수정내용
docs/이슈번호-문서명

예시

feat/1-login
feat/7-yolo-training
fix/12-api-error
docs/9-dataset-structure

---

Commit 컨벤션

Commit 태그 종류

✨ [FEAT]      새로운 기능 구현
👩🏻‍🔧 [FIX]      버그 및 오류 해결
📊 [DATA]      데이터셋 구축, 라벨링, 전처리
📝 [DOCS]      README 및 문서 수정
🔧 [MODIFY]    기능 변화가 포함된 코드 수정
🧪 [TEST]      실험, 모델 평가 및 테스트
🧹 [CHORE]     환경 설정 및 기타 작업
🪄 [REFACTOR]  기능 변경 없는 코드 개선

Commit 메시지 형식

#이슈번호 [태그] 작업 내용

예시

#2 [DATA] Monkey 데이터셋 추가
#3 [DATA] Braille 라벨링 완료
#7 [FEAT] YOLO 모델 학습 코드 추가
#8 [TEST] 모델 성능 평가 진행
#9 [DOCS] Dataset 구조 문서 작성
#12 [FIX] API 응답 오류 수정

---

Issue 컨벤션

Issue 태그 종류

[FEAT]
[FIX]
[DATA]
[DOCS]
[MODIFY]
[TEST]
[CHORE]
[REFACTOR]

Issue 제목 형식

[태그] 작업 내용

예시

[DATA] 데이터 라벨링
[FEAT] YOLO 모델 학습
[TEST] 모델 성능 평가
[DOCS] Dataset 구조 문서 작성

---

협업 절차

1. Issue 생성
2. 담당자 지정
3. 브랜치 생성
4. 개발 진행
5. Pull Request 생성
6. Self Review 진행
7. Merge

---

협업 시 참고 사항

• 모든 작업은 Issue 생성 후 진행합니다.
• 진행 상황은 GitHub Project를 통해 관리합니다.
• 기술적 의사결정은 Discussion에 기록합니다.
• 질문은 '질문 및 답변' 카테고리를 활용합니다.
• 개발 결과 및 실험 결과는 '결과 공유' 카테고리를 활용합니다.
• 중요한 변경 사항은 PR 또는 Discussion을 통해 공유합니다.

원활한 협업을 위해 위 규칙을 함께 지켜주시기 바랍니다. 🚀

[happynarin05]

전부 확인했습니다 !

[yeverycode]

확인 감사합니다 나린님 !!

[owonye]

확인했습니다!

[yeverycode]

확인 감사합니다 여원님 😊