문제 및 풀 요청 템플릿을 사용하면 기여자가 저장소에 제공하는 정보를 표준화할 수 있습니다. 문제 템플릿은 사용자가 제출하는 문제 유형과 사용 가능한 템플릿 유형에 따라 선택할 수 있는 사전 정의된 옵션을 제공합니다. pull 요청 템플릿은 모든 pull 요청에 자동으로 적용되어 저장소에 일관되게 기여할 수 있습니다.
템플릿은 저장소에서 파일을 병합할 권한이 있는 사용자가 만들 수 있습니다.
문제 템플릿 만들기
Secure Source Manager를 사용하면 저장소의 여러 위치에 있는 Markdown 파일을 사용하여 문제 템플릿을 정의할 수 있습니다. 다양한 용도로 여러 문제 템플릿을 만들 수 있습니다. 예를 들어 버그를 신고하고 기능 요청을 제출하는 템플릿을 별도로 만들 수 있습니다.
다음 정보를 정확한 형식으로 시작하는 템플릿을 만듭니다.
---
name: TEMPLATE_NAME
about: Insert description of template
title: Placeholder title for the new issue when it is created
---
이름과 설명을 입력합니다. 필수이며 새 문제 페이지의 UI에서 사용됩니다.
새 문제가 생성될 때 자리표시자 제목으로 사용되는 제목을 선택적으로 포함할 수 있습니다.
필수 자료 아래에 문제 설명에 표시되어 사용자가 필요한 정보를 제공하는 데 도움이 되는 정보를 포함합니다.
다음 위치 중 하나에 템플릿을 마크다운 파일로 저장합니다.
/.securesourcemanager/ISSUE_TEMPLATES/
/.securesourcemanager/issue_templates/
기본 문제 템플릿
Secure Source Manager는 단일 기본 템플릿의 정의도 지원합니다. 이 템플릿은 다음 위치 중 하나에 정의되어야 합니다.
/.securesourcemanager/ISSUE_TEMPLATE.md
/.securesourcemanager/issue_template.md
사용자가 새 문제를 만들면 Secure Source Manager에서 사용자가 템플릿을 선택하도록 프롬프트하거나(사용 가능한 템플릿이 있는 경우) 기본 템플릿을 선택합니다. 지정된 기본 템플릿이 없으면 새 문제에 아무것도 미리 채워지지 않습니다.
문제 예시 템플릿
템플릿의 처음 5줄은 다음 예에 설명된 규칙을 따라야 합니다. 추가 정보는 문제 유형의 요구사항에 맞게 마크다운으로 서식을 지정할 수 있습니다.
---
name: Bug #Used as UI element for the button on the New Issues page
about: Use this template to submit a new bug #Used as description text on the New Issues page
title: [BUG]: <Describe issue> #Used as placeholder name for newly created issue
---
# Description
# Expected result
# Actual result
# Steps to reproduce
1.
2.
# Environment
-OS:
-Software version:
-Screenshots:
풀 요청 템플릿 만들기
다음 정보를 정확한 형식으로 시작하는 템플릿을 만듭니다.
---
title: "[PR]: <Insert title>"
---
필수 자료 아래에 문제 설명에 표시하여 사용자가 필요한 정보를 제공하는 데 도움이 되는 정보를 포함합니다. 자세한 내용은 다음 섹션의 템플릿 예를 참고하세요.
템플릿을 저장소 내 다음 위치 중 하나에 마크다운 파일로 저장합니다.
/.securesourcemanager/PULL_REQUEST_TEMPLATE.md
/.securesourcemanager/pull_request_template.md
새 풀 요청을 만들면 Secure Source Manager가 정의된 위치에 템플릿이 있는지 확인하고 템플릿을 로드합니다. 템플릿에 title 정보를 포함한 경우 사용자가 따라야 하는 형식을 제공하기 위해 새 풀 요청에 자동으로 채워집니다. 포함된 추가 정보는 제출 사용자가 업데이트할 수 있도록 풀 요청 설명에 추가됩니다.
풀 요청 템플릿 예시
템플릿의 처음 3줄은 다음 예에 표시된 규칙을 따라야 합니다. 다음에 나오는 모든 내용은 옵션이며 사용자가 규칙을 따르는 풀 요청을 만드는 데 도움이 됩니다.
---
title: "[PR]: <Insert title>"
---
<!-- Thank you for your contribution! -->
<!-- Include if applicable: -->
Fixes: #nnn <!-- tracking issues that this PR will close -->
**Related**: _Relevant tracking issues, for context_
**Merge before/after**: _Dependent or prerequisite PRs_
**Description**
<!-- Describe your changes here. The more detail, the easier the review! -->
**User facing changes (remove if N/A)**
<!-- Describe any user facing changes this PR introduces. -->
<!-- "Before" and "After" sections work great - bonus points for screenshots! -->
<!-- Be sure all docs have been updated as well! -->
**Follow-up Work (remove if N/A)**
<!-- Mention any related follow up work to this PR. -->
다음 단계
Secure Source Manager에서 문제 및 풀 요청을 사용하는 방법에 관한 자세한 내용은 문제 및 풀 요청 작업을 참고하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Create issue and pull request templates\n\nThis page describes how to create and configure issues templates and pull request templates for Secure Source Manager.\n\n\u003cbr /\u003e\n\nRequired roles\n--------------\n\n\nTo get the permissions that\nyou need to work with issues and pull request templates,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- [Secure Source Manager Instance Accessor](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.instanceAccessor) (`roles/securesourcemanager.instanceAccessor`) on the Secure Source Manager instance\n- [Secure Source Manager Repo Writer](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoWriter) (`roles/securesourcemanager.repoWriter`) on the repository\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nFor information on granting Secure Source Manager roles,\nsee [Access control with IAM](/secure-source-manager/docs/access-control) and\n[Grant users instance access](/secure-source-manager/docs/grant-users-instance-access).\n\nTemplates overview\n------------------\n\nIssues and pull request templates let you standardize the\ninformation contributors provide to a repository. Issue templates offer\npredefined options a user can choose from depending on the type of issue they\nare submitting and the template types available. A pull request template is\nautomatically applied to all pull requests, ensuring consistent contributions to\nthe repository.\n\nTemplates can be created by anyone with permission to merge files in a\nrepository.\n\nCreate an issues template\n-------------------------\n\nSecure Source Manager lets you define issues templates using Markdown files in multiple\nlocations in your repository. You can create multiple issue templates for\ndifferent purposes. For example, you may want to have a separate templates for\nreporting bugs and submitting feature requests.\n\n1. Create a template that begins with the following information, in this exact\n format:\n\n ---\n name: TEMPLATE_NAME\n about: Insert description of template\n title: Placeholder title for the new issue when it is created\n ---\n\n2. Provide a name, and description. These are required and are used in the UI\n of the New Issues page.\n\n3. You can optionally include a title that is used as a placeholder title when a\n new issue is created.\n\n4. Below the required material, include any information you would like to\n be visible in the issue description that will assist users in providing\n necessary information.\n\n5. Save your template as a Markdown file in one of the following locations:\n\n - `/.securesourcemanager/ISSUE_TEMPLATES/`\n - `/.securesourcemanager/issue_templates/`\n\n| **Note:** If templates are found in more than one location, Secure Source Manager uses the template from the first folder in your directory.\n\n### Default issues template\n\nSecure Source Manager also supports the definition of a single default template. This\ntemplate should be defined in one of the following locations:\n\n- `/.securesourcemanager/ISSUE_TEMPLATE.md`\n- `/.securesourcemanager/issue_template.md`\n\nWhen a user creates a new issue, Secure Source Manager prompts that user to select a\ntemplate, if any are available, or selects the default template. If there's no\ndesignated default template, nothing is pre populated into the new issue.\n\n### Example Issues template\n\nThe first 5 lines of the template must follow the conventions outlined in the\nfollowing example. Any additional information can be formatted in Markdown to\nsuit the needs of the issue type. \n\n ---\n name: Bug #Used as UI element for the button on the New Issues page\n about: Use this template to submit a new bug #Used as description text on the New Issues page\n title: [BUG]: \u003cDescribe issue\u003e #Used as placeholder name for newly created issue\n ---\n # Description\n\n # Expected result\n\n # Actual result\n\n # Steps to reproduce\n 1.\n 2.\n\n # Environment\n -OS:\n -Software version:\n -Screenshots:\n\nCreate a pull request template\n------------------------------\n\n1. Create a template that begins with the following information, in this exact\n format:\n\n ---\n title: \"[PR]: \u003cInsert title\u003e\"\n ---\n\n2. Below the required material, include any information you would like to\n be visible in the issue description to assist users in providing\n necessary information. See the example template in the following section for\n more details.\n\n3. Save the template as a Markdown file in one of the following locations inside\n a repository:\n\n - `/.securesourcemanager/PULL_REQUEST_TEMPLATE.md`\n - `/.securesourcemanager/pull_request_template.md`\n\nWhen you create a new pull request, Secure Source Manager checks if a template exists in\nany of the defined locations and loads it. If you included **title** information\nin your template, it's automatically populated in the new pull request to\nprovide users with a defined format to follow. Any additional information you\nincluded is added to the pull request description to be updated by the\nsubmitting user.\n\n### Example Pull Request template\n\nThe first 3 lines of the template must follow the conventions shown in the\nfollowing example. Everything that follows is options and should assist your\nusers in creating pull requests that follow your conventions. \n\n ---\n title: \"[PR]: \u003cInsert title\u003e\"\n ---\n \u003c!-- Thank you for your contribution! --\u003e\n\n \u003c!-- Include if applicable: --\u003e\n Fixes: #nnn \u003c!-- tracking issues that this PR will close --\u003e\n **Related**: _Relevant tracking issues, for context_\n **Merge before/after**: _Dependent or prerequisite PRs_\n\n **Description**\n \u003c!-- Describe your changes here. The more detail, the easier the review! --\u003e\n\n **User facing changes (remove if N/A)**\n \u003c!-- Describe any user facing changes this PR introduces. --\u003e\n \u003c!-- \"Before\" and \"After\" sections work great - bonus points for screenshots! --\u003e\n \u003c!-- Be sure all docs have been updated as well! --\u003e\n\n **Follow-up Work (remove if N/A)**\n \u003c!-- Mention any related follow up work to this PR. --\u003e\n\nWhat's next\n-----------\n\n- Visit [Work with issues and pull requests](/secure-source-manager/docs/work-with-issues-pull-requests) for details on how to work with issues and pull requests in Secure Source Manager."]]
