사용자가 직접 Issue를 생성할 수 없는 이유

1 month ago 10

  • Ghostty 저장소는 사용자가 직접 Issue를 생성할 수 없고, 먼저 GitHub Discussions에서 논의를 시작해야 함
  • 프로젝트는 버그나 기능 요청 논의에 Issue 트래커를 사용하지 않으며, 모든 논의는 Discussions에서 진행됨
  • 논의가 충분히 구체화되어 실행 가능한 항목으로 정리되면, 관리자가 이를 Issue로 변환함
  • 이러한 방식은 유지보수자와 기여자가 실제 작업 가능한 이슈를 빠르게 찾도록 돕는 구조
  • 대부분의 보고가 사용자 환경 문제나 오해, 미구현 기능 요청이기 때문에, 이 절차는 프로젝트 품질 관리에 중요함

Issue 생성 제한 정책

  • Ghostty 저장소에서는 사용자가 직접 Issue를 생성할 수 없음
    • 대신 먼저 GitHub Discussions에서 문제나 제안을 공유해야 함
    • 관리자가 논의를 검토해 명확히 재현 가능한 문제로 확인되면 Issue로 변환함
  • 이 방식은 Issue 트래커를 실제 작업 가능한 항목만 포함하도록 유지하기 위한 구조임
    • 모든 Issue가 이미 구체화된 상태이므로, 기여자들이 바로 작업을 시작할 수 있음

Issue 트래커 운영 원칙

  • Ghostty는 Issue 트래커를 토론이나 기능 요청용으로 사용하지 않음
    • 기능 요청이나 일반 질문은 Discussions에서 처리함
    • Issue는 명확히 정의된 버그나 실행 가능한 작업 항목만 포함함
  • 이 접근법은 오픈소스 프로젝트 유지 경험을 바탕으로 형성된 운영 원칙
    • 과거 경험상, 사용자 보고의 80~90%가 실제 버그가 아닌 오해나 환경 문제였음
    • 나머지 대부분은 미구현 기능 요청으로, 추가 명세가 필요한 경우가 많았음

유지보수 효율성 향상

  • Discussions 단계를 거치면 유지보수자가 검증된 문제만 Issue로 관리할 수 있음
    • 불필요한 중복 보고나 잘못된 버그 리포트를 줄임
    • Issue 목록이 즉시 작업 가능한 항목 중심으로 정리
  • 사용자는 유효한 문제를 찾아도 추가 작업을 할 필요 없음
    • 관리자가 직접 Issue로 변환해 처리함

참고 문서

  • 자세한 절차와 기여 지침은 CONTRIBUTING.md 파일에서 확인 가능
  • 해당 문서에는 Discussions 참여 방식과 Issue 전환 기준이 명시되어 있음

Read Entire Article