새 리소스 타입을 추가할 때, 그것이 Issue의 "확장"(Issue Type)이어야 하는지 아니면 새로운 일급 리소스 타입(이슈, 에픽, 머지 리퀘스트, 스니펫과 유사한 타입)이어야 하는지 분명하지 않은 경우가 있습니다.

Issue Types라는 개념은 이 이슈에서 처음 제안되었고, 그 활용 방안은 이후 인시던트 관리를 비롯해 여러 차례 논의되었습니다.

Issue Type 개요#

Issue Type은 기존 Issue 타입을 확장한 리소스 타입으로, Issue가 쓰이는 곳이라면 어디에서나 사용할 수 있습니다. 예를 들어 이슈를 나열하거나 검색할 때, 또는 에픽에서 해당 타입의 객체를 연결할 때 사용합니다. Issue Type은 동일한 issues 테이블을 사용해야 하며, 추가 필드는 별도 테이블에 저장할 수 있습니다.

Issue Type 사용 시점#

• 새 타입이 기본 Issue 타입의 기존 필드를 제거하지 않고 새 필드만 추가하는 경우입니다(기본 Issue 타입의 일부 필드를 사용자 인터페이스나 API에서 숨기는 것은 문제가 없습니다).
• 새 타입을 기본 Issue 타입이 쓰이는 모든 곳에서 사용할 수 있는 경우입니다.

일급 리소스 타입 사용 시점#

• 새 리소스에 별도의 모델과 테이블을 사용하는 경우입니다.

• 기본 Issue 타입의 일부 필드를 제거해야 하는 경우입니다. UI에서 숨기는 것은 문제가 없지만 완전한 제거는 해당하지 않습니다.

• 새 리소스를 기본 Issue 타입 대신 사용할 수 없는 경우입니다. 예를 들면 다음과 같습니다.

  • 에픽에 추가할 수 없습니다.
  • 커밋이나 머지 리퀘스트에서 닫을 수 없습니다.
  • 다른 이슈와 관련 항목으로 표시할 수 없습니다.

Issue 타입을 사용할 수 없는 경우에도 일급 타입을 정의한 다음 Issuable 이나 Noteable 같은 컨선을 포함해 이슈 관련 리소스 전반에 공통인 기능을 재사용할 수 있습니다. 다만 이 경우에도 새 리소스를 다루는 인터페이스를 정의하고 새 타입과 연동되도록 다른 여러 구성 요소를 갱신해야 합니다.

Issue 타입을 사용하면 해당 타입에서 쓸 수 있는 필드나 기능, 또는 양쪽 모두가 제한됩니다. 다만 이 기능은 기본으로 제공됩니다.