기본 커뮤니티 상태 파일 정보
기본 커뮤니티 상태 파일은 정상 및 공동 오픈 소스 프로젝트 유지관리를 위한 지침 및 템플릿을 제공하는 미리 정의된 파일 집합입니다. 이러한 파일은 프로젝트의 개발 및 커뮤니티 상호 작용의 다양한 측면을 자동화하고 표준화하여 투명성, 모범 사례, 공동 작업을 촉진하는 데 도움이 됩니다.
.github
라는 퍼블릭 리포지토리에 기본 커뮤니티 상태 파일을 추가할 수 있으며 GitHub Enterprise Cloud는 다음 순서대로 해당 형식의 자체 파일이 없는 계정 소유의 모든 리포지토리에 대한 기본 파일을 사용하고 표시합니다.
.github
폴더- 리포지토리의 루트
docs
폴더
현재 리포지토리에 해당 파일이 없으면 GitHub Enterprise Cloud는 동일한 우선 순위에 따라 .github
리포지토리의 기본 파일을 사용합니다.
예를 들어 자체 CONTRIBUTING.md
파일이 없는 리포지토리에서 문제 또는 끌어오기 요청을 생성하는 사용자는 .github
리포지토리의 기본 CONTRIBUTING.md
에 대한 링크를 볼 수 있습니다. 그러나 리포지토리의 자체 .github/ISSUE_TEMPLATE
폴더에 문제 템플릿이나 _config.yml
파일과 같은 파일이 있는 경우 기본 .github/ISSUE_TEMPLATE
폴더의 콘텐츠는 사용되지 않습니다. 이렇게 하면 리포지토리 유지 관리자가 리포지토리별로 특정 템플릿 또는 콘텐츠를 사용하여 기본 파일을 재정의할 수 있습니다.
파일을 .github
리포지토리에 저장하면 기본값을 한 곳에서 변경할 수 있습니다. 또한 개별 리포지토리의 파일 브라우저 또는 Git 기록에 표시되지 않으며 복제본, 패키지 또는 다운로드에도 포함되지 않습니다.
리포지토리 유지 관리자는 커뮤니티 표준 체크리스트를 사용하여 프로젝트가 사람들이 프로젝트를 사용하고 참여하는 데 도움이 되는 권장 커뮤니티 기준을 충족하는지 확인할 수 있습니다. 자세한 내용은 "퍼블릭 리포지토리에 대한 커뮤니티 프로필 정보"을(를) 참조하세요.
지원되는 파일 형식
다음 커뮤니티 상태 파일에 대한 조직 또는 개인 계정에서 기본값을 만들 수 있습니다.
커뮤니티 상태 파일 | 설명 |
---|---|
CODE_OF_CONDUCT.md | CODE_OF_CONDUCT 파일은 커뮤니티에 참여하는 방법에 대한 표준을 정의합니다. 자세한 내용은 "프로젝트에 사용 규정 추가"을(를) 참조하세요. |
CONTRIBUTING.md | 기여 파일은 사람들이 프로젝트에 기여하는 방법을 전달합니다. 자세한 내용은 "리포지토리 기여자에 대한 지침 설정"을(를) 참조하세요. |
토론 범주 양식 | 토론 범주 양식은 커뮤니티 구성원이 리포지토리에서 새 토론을 열 때 사용할 수 있는 템플릿을 사용자 지정합니다. 자세한 내용은 "토론 범주 양식 만들기"을(를) 참조하세요. |
FUNDING.yml | FUNDING 파일은 오픈 소스 프로젝트에 대한 자금 조달 옵션의 가시성을 높이기 위해 리포지토리에 스폰서 단추를 표시합니다. 자세한 내용은 "리포지토리에 스폰서 단추 표시"을(를) 참조하세요. |
GOVERNANCE.md | GOVERNANCE 파일을 사용하면 프로젝트가 어떻게 관리되는지 알 수 있습니다. 예를 들어 프로젝트 역할과 결정 방법에 대해 논의할 수 있습니다. |
이슈 및 끌어오기 요청 템플릿과 config.yml | 문제 및 끌어오기 요청 템플릿은 리포지토리에서 문제 및 끌어오기 요청을 열 때 기여자가 포함할 정보를 사용자 지정하고 표준화합니다. 자세한 내용은 "문제 및 끌어오기 요청 템플릿 사용"을(를) 참조하세요. |
SECURITY.md | SECURITY 파일은 프로젝트에서 보안 약점을 보고하는 방법에 대한 지침 밒 파일을 hiperlink하는 설명을 제공합니다. 자세한 내용은 "Adding a security policy to your repository(리포지토리에 보안 정책 추가)"을(를) 참조하세요. |
SUPPORT.md | SUPPORT 파일을 사용하면 프로젝트에 대한 도움을 얻을 수 있는 방법에 대해 알 수 있습니다. 자세한 내용은 "프로젝트에 지원 리소스 추가"을(를) 참조하세요. |
기본 라이선스 파일을 만들 수 없습니다. 프로젝트를 복제, 패키지 또는 다운로드할 때 파일이 포함되도록 라이선스 파일을 개별 리포지토리에 추가해야 합니다.
기본 파일에 대한 리포지토리 만들기
-
임의 페이지의 오른쪽 위에 있는 을(를) 클릭한 다음, 신규 리포지토리를 클릭합니다.
-
소유자 드롭다운 메뉴를 사용하고 기본 파일을 만들려는 조직 또는 개인 계정을 선택합니다.
-
‘리포지토리 이름’ 필드에 .github를 입력하세요.
-
필요에 따라 ‘설명’ 필드에 설명을 입력합니다.
-
리포지토리 상태가 공용으로 설정되어 있는지 확인합니다. 기본 파일의 리포지토리는 비공개일 수 없습니다.
-
추가 정보를 사용하여 이 리포지토리 초기화를 선택합니다.
-
Create repository(리포지토리 만들기)를 클릭합니다.
-
리포지토리에서 지원되는 커뮤니티 상태 파일 중 하나를 만듭니다. 이슈 템플릿 및 해당 구성 파일은
.github/ISSUE_TEMPLATE
폴더에 있어야 합니다. 기타 지원되는 모든 파일은 리포지토리의 루트,.github
폴더 또는docs
폴더에 있을 수 있습니다. 자세한 내용은 "새 파일 만들기" 항목을 참조하세요.