Skip to main content

문제 및 끌어오기 요청 템플릿 사용

문제 및 끌어오기 요청 템플릿을 사용하면 기여자가 리포지토리에서 문제를 공개하고 요청을 끌어올 때 포함시키도록 하고 싶은 정보를 사용자 지정하고 표준화할 수 있습니다.

리포지토리에서 문제를 만들고 요청 템플릿을 끌어오면 기여자는 템플릿을 사용하여 문제를 열거나 리포지토리의 기여 지침에 따라 끌어오기 요청에서 제안된 변경 내용을 설명할 수 있습니다. 리포지토리에 기여 지침을 추가하는 방법에 대한 자세한 내용은 "리포지토리 기여자에 대한 지침 설정"을 참조하세요.

조직 또는 개인 계정에 대한 기본 문제 및 끌어오기 요청 템플릿을 만들 수 있습니다. 자세한 내용은 "Creating a default community health file(기본 커뮤니티 상태 파일 만들기)"을(를) 참조하세요.

문제 템플릿

문제 템플릿 빌더 또는 이슈 양식을 사용하여 리포지토리에 대한 문제 템플릿을 만드는 경우 기여자는 리포지토리에서 새 문제를 열 때 적절한 템플릿을 선택할 수 있습니다.

여러 템플릿 중에서 선택할 수 있는 새 이슈 페이지의 스크린샷

문제 템플릿은 참가자가 문제의 내용을 지정할 수 있도록 하면서 문제를 열기 위한 지침을 제공하려는 경우에 유용합니다. 참가자가 이슈를 열 때 특정하고 구조화된 정보를 제공하려는 경우 이슈 양식을 통해 원하는 정보를 받을 수 있습니다.

템플릿 작성기를 사용하여 각 템플릿에 대한 제목과 설명을 지정하고, 템플릿 콘텐츠를 추가하고, 템플릿을 기본 분기에 커밋하거나 리포지토리에서 끌어오기 요청을 열 수 있습니다. 템플릿 작성기는 템플릿이 새 문제 페이지에 표시되는 데 필요한 YAML 전면 문제 태그를 자동으로 추가합니다. 자세한 내용은 "리포지토리에 대한 문제 템플릿 구성"을(를) 참조하세요.

이슈 양식을 사용하면 GitHub 양식 스키마를 사용하여 웹 양식 필드가 있는 템플릿을 만들 수 있습니다. 기여자가 문제 양식을 사용하여 문제를 열면 양식 입력이 표준 Markdown 문제 주석으로 변환됩니다. 참가자가 리포지토리에서 실행 가능한 문제를 열 수 있도록 다양한 입력 유형을 지정하고 필요에 따라 입력을 설정할 수 있습니다. 자세한 내용은 "리포지토리에 대한 문제 템플릿 구성" 및 "문제 양식 구문"을(를) 참조하세요.

.github/ISSUE_TEMPLATE 폴더에 config.yml 파일을 추가하여 사용자가 리포지토리에서 새 이슈를 만들 때 표시되는 이슈 템플릿 선택기를 사용자 지정할 수 있습니다. 자세한 내용은 "리포지토리에 대한 문제 템플릿 구성"을 참조하세요.

문제 템플릿은 숨겨진 .github/ISSUE_TEMPLATE 디렉터리에 있는 리포지토리의 기본 분기에 저장됩니다. 다른 분기에서 템플릿을 만드는 경우 협력자가 사용할 수 없습니다. 이슈 템플릿 파일 이름은 대/소문자를 구분하지 않으며 .md 확장자가 필요합니다. 이슈 양식으로 만든 이슈 템플릿에는 .yml 확장자가 필요합니다. 검사마크를 커뮤니티 프로필 검사 목록에 표시하려면 문제 템플릿이 .github/ISSUE_TEMPLATE 폴더에 있어야 하며 유효한 name: 및 YAML 프런트매터(.md 파일에 정의된 문제 템플릿의 경우)의 about: 키 또는 name:description: 키(.yml 파일에 정의된 문제 양식의 경우)에 있어야 합니다.

레거시 문제 템플릿 워크플로를 사용하여 Markdown에서 단일 문제 템플릿을 수동으로 만들 수 있으며 프로젝트 참가자는 문제 본문에 템플릿의 콘텐츠를 자동으로 볼 수 있습니다. 그러나 업그레이드된 여러 이슈 템플릿 작성기 또는 발급 양식을 사용하여 이슈 템플릿을 만드는 것이 좋습니다. 레거시시 워크플로로에 대한 자세한 내용은 "리포지토리에 대한 단일 문제 템플릿 수동으로 만들기"을 참조하세요.

보안 정책을 만들어 프로젝트의 보안 취약성을 보고하는 지침을 사용자에게 제공할 수 있습니다. 자세한 내용은 "Adding a security policy to your repository(리포지토리에 보안 정책 추가)"을 참조하세요.

끌어오기 요청 템플릿

리포지토리에 끌어오기 요청 템플릿을 추가하면 프로젝트 기여자가 끌어오기 요청 본문에서 템플릿의 콘텐츠를 자동으로 볼 수 있습니다.

리포지토리의 기본 분기에 템플릿을 만들어야 합니다. 다른 분기에서 만든 템플릿은 협력자가 사용할 수 없습니다. 끌어오기 요청 템플릿을 리포지토리의 표시되는 루트 디렉터리, docs 폴더 또는 숨겨진 .github 디렉터리에 저장할 수 있습니다. 끌어오기 요청 템플릿 파일 이름은 대/소문자를 구분하지 않으며 확장명(예: .md 또는 .txt)을 가질 수 있습니다.

자세한 내용은 "리포지토리에 대한 끌어오기 요청 템플릿 만들기"을(를) 참조하세요.