Ninth Korean l10n work for release 1.18
- Fix error in k8s.io/ko/docs/concepts/workloads/pods/pod-lifecycle/ (#22681) - Translate docs/reference/setup-tools/kubeadm/kubeadm.md in Korean (#22684) - Update outdated files in dev-1.18-ko.9 branch (#22686) - Fix issues of ko-doc links in translated docs (#22718) - Translate concepts/cluster-administration/monitoring.md into Korean (#22808) - Translate tasks/access-application-cluster/service-access-application-cluster in Korean (#22800) - Translate concepts/storage/storage-limits.md into Korean (#22795) Co-authored-by: Jihoon Seo <jihoon.seo@etri.re.kr> Co-authored-by: Reung37 <reung37@naver.com> Co-authored-by: Seokho Son <shsongist@gmail.com> Co-authored-by: Jerry Park <jaehwa@gmail.com> Co-authored-by: coolguyhong <podolsmith@naver.com>
This commit is contained in:
@@ -28,41 +28,62 @@ card:
|
||||
|
||||
## 시작하기
|
||||
|
||||
누구든지 문서에 대한 이슈를 오픈 또는 풀 리퀘스트(PR)를 사용해서 [`kubernetes/website` GitHub 리포지터리](https://github.com/kubernetes/website)에 변경하는 기여를 할 수 있습니다. 당신이 쿠버네티스 커뮤니티에 효과적으로 기여하려면 [git](https://git-scm.com/)과 [GitHub](https://lab.github.com/)에 익숙해야 합니다.
|
||||
누구든지 문서에 대한 이슈를 오픈 또는 풀 리퀘스트(PR)를 사용해서
|
||||
[`kubernetes/website` GitHub 리포지터리](https://github.com/kubernetes/website)에
|
||||
변경하는 기여를 할 수 있습니다.
|
||||
쿠버네티스 커뮤니티에 효과적으로 기여하려면
|
||||
[git](https://git-scm.com/)과
|
||||
[GitHub](https://lab.github.com/)에
|
||||
익숙해야 합니다.
|
||||
|
||||
문서에 참여하려면
|
||||
|
||||
1. CNCF [Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md)에 서명합니다.
|
||||
2. [문서 리포지터리](https://github.com/kubernetes/website) 와 웹사이트의 [정적 사이트 생성기](https://gohugo.io)를 숙지합니다.
|
||||
3. [풀 리퀘스트 열기](/ko/docs/contribute/new-content/new-content/)와 [변경 검토](/ko/docs/contribute/review/reviewing-prs/)의 기본 프로세스를 이해하도록 합니다.
|
||||
1. [문서 리포지터리](https://github.com/kubernetes/website)와 웹사이트의
|
||||
[정적 사이트 생성기](https://gohugo.io)를 숙지합니다.
|
||||
1. [풀 리퀘스트 열기](/ko/docs/contribute/new-content/new-content/)와
|
||||
[변경 검토](/ko/docs/contribute/review/reviewing-prs/)의
|
||||
기본 프로세스를 이해하도록 합니다.
|
||||
|
||||
일부 작업에는 쿠버네티스 조직에서 더 많은 신뢰와 더 많은 접근이 필요할 수 있습니다.
|
||||
역할과 권한에 대한 자세한 내용은
|
||||
[SIG Docs 참여](/ko/docs/contribute/participating/)를 봅니다.
|
||||
[SIG Docs 참여](/ko/docs/contribute/participate/)를 봅니다.
|
||||
|
||||
## 첫 번째 기여
|
||||
|
||||
- [기여 개요](/ko/docs/contribute/new-content/overview/)를 읽고 기여할 수 있는 다양한 방법에 대해 알아봅니다.
|
||||
- [kubernetes/website에 기여하기](https://github.com/kubernetes/website/contribute)를 참조하여 좋은 진입점이 되는 이슈를 찾을 수 있습니다.
|
||||
- 기존 문서에 대해 [GitHub을 사용해서 풀 리퀘스트 열거나](/ko/docs/contribute/new-content/new-content/#github을-사용하여-변경하기) GitHub에서의 이슈 제기에 대해 자세히 알아봅니다.
|
||||
- 정확성과 언어에 대해 다른 쿠버네티스 커뮤니티 맴버의 [풀 리퀘스트 검토](/ko/docs/contribute/review/reviewing-prs/)를 합니다.
|
||||
- 쿠버네티스 [콘텐츠](/docs/contribute/style/content-guide/)와 [스타일 가이드](/docs/contribute/style/style-guide/)를 읽고 정보에 대한 코멘트를 남길 수 있습니다.
|
||||
- [페이지 템플릿 사용](/docs/contribute/style/page-content-types/)과 [휴고(Hugo) 단축코드(shortcodes)](/docs/contribute/style/hugo-shortcodes/)를 사용해서 큰 변경을 하는 방법에 대해 배워봅니다.
|
||||
- [기여 개요](/ko/docs/contribute/new-content/overview/)를 읽고
|
||||
기여할 수 있는 다양한 방법에 대해 알아봅니다.
|
||||
- [kubernetes/website에 기여하기](https://github.com/kubernetes/website/contribute)를
|
||||
참조하여 좋은 진입점이 되는 이슈를 찾을 수 있습니다.
|
||||
- 기존 문서에 대해 [GitHub을 사용해서 풀 리퀘스트 열거나](/ko/docs/contribute/new-content/new-content/#github을-사용하여-변경하기)
|
||||
GitHub에서의 이슈 제기에 대해 자세히 알아봅니다.
|
||||
- 정확성과 언어에 대해 다른 쿠버네티스 커뮤니티 맴버의
|
||||
[풀 리퀘스트 검토](/ko/docs/contribute/review/reviewing-prs/)를 합니다.
|
||||
- 쿠버네티스 [콘텐츠](/docs/contribute/style/content-guide/)와
|
||||
[스타일 가이드](/docs/contribute/style/style-guide/)를 읽고 정보에 대한 코멘트를 남길 수 있습니다.
|
||||
- [페이지 콘텐츠 유형](/docs/contribute/style/page-content-types/)과
|
||||
[휴고(Hugo) 단축코드(shortcodes)](/docs/contribute/style/hugo-shortcodes/)에 대해 배워봅니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
- 리포지터리의 [로컬 복제본에서 작업](/ko/docs/contribute/new-content/new-content/#fork-the-repo)하는 방법을 배워봅니다.
|
||||
- 리포지터리의 [로컬 복제본에서 작업](/ko/docs/contribute/new-content/new-content/#fork-the-repo)하는
|
||||
방법을 배워봅니다.
|
||||
- [릴리스된 기능](/docs/contribute/new-content/new-features/)을 문서화 합니다.
|
||||
- [SIG Docs](/ko/docs/contribute/participating/)에 참여하고, [멤버 또는 검토자](/ko/docs/contribute/participating/#역할과-책임)가 되어봅니다.
|
||||
- [SIG Docs](/ko/docs/contribute/participate/)에 참여하고,
|
||||
[멤버 또는 검토자](/ko/docs/contribute/participate/roles-and-responsibilities/)가 되어봅니다.
|
||||
|
||||
- [현지화](/ko/docs/contribute/localization_ko/)를 시작하거나 도와줍니다.
|
||||
|
||||
## SIG Docs에 참여
|
||||
|
||||
[SIG Docs](/ko/docs/contribute/participating/)는 쿠버네티스 문서와 웹 사이트를 게시하고 관리하는 기여자 그룹입니다. SIG Docs에 참여하는 것은 쿠버네티스 기여자(기능 개발 및 다른 여러가지)가 쿠버네티스 프로젝트에 가장 큰 영향을 미칠 수 있는 좋은 방법입니다.
|
||||
[SIG Docs](/ko/docs/contribute/participate/)는 쿠버네티스 문서와 웹 사이트를 게시하고
|
||||
관리하는 기여자 그룹입니다. SIG Docs에 참여하는 것은
|
||||
쿠버네티스 기여자(기능 개발 및 다른 여러가지)가 쿠버네티스 프로젝트에 가장 큰 영향을
|
||||
미칠 수 있는 좋은 방법입니다.
|
||||
|
||||
SIG Docs는 여러가지 방법으로 의견을 나누고 있습니다.
|
||||
|
||||
- [쿠버네티스 슬랙 인스턴스에서 `#sig-docs` 에 가입](http://slack.k8s.io/)을 하고,
|
||||
- [쿠버네티스 슬랙 인스턴스에서 `#sig-docs` 에 가입](https://slack.k8s.io/)하고,
|
||||
자신을 소개하세요!
|
||||
- 더 광범위한 토론이 이루어지고 공식적인 결정이 기록이 되는
|
||||
[`kubernetes-sig-docs` 메일링 리스트에 가입](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) 하세요.
|
||||
|
||||
@@ -19,7 +19,8 @@ weight: 98
|
||||
|
||||
## 개선 제안
|
||||
|
||||
SIG Docs [멤버](/ko/docs/contribute/participating/#멤버)는 개선을 제안할 수 있다.
|
||||
SIG Docs [멤버](/ko/docs/contribute/participate/roles-and-responsibilities/#멤버)는
|
||||
개선을 제안할 수 있다.
|
||||
|
||||
한 동안 쿠버네티스 문서에 기여한 후에,
|
||||
[스타일 가이드](/docs/contribute/style/style-guide/),
|
||||
@@ -42,12 +43,12 @@ website 스타일, 풀 리퀘스트 리뷰와 병합
|
||||
|
||||
## 쿠버네티스 릴리스를 위한 문서 조정
|
||||
|
||||
SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 쿠버네티스
|
||||
릴리스에 대한 문서를 조정할 수 있다.
|
||||
SIG Docs [승인자](/ko/docs/contribute/participate/roles-and-responsibilities/#승인자)는
|
||||
쿠버네티스 릴리스에 대한 문서를 조정할 수 있다.
|
||||
|
||||
각 쿠버네티스 릴리스는 sig-release SIG(Special Interest Group)에 참여하는
|
||||
사람들의 팀에 의해 조정된다. 특정 릴리스에 대한 릴리스 팀의 다른 구성원에는
|
||||
전체 릴리스 리드와 sig-pm, sig-testing 및 기타 담당자가
|
||||
전체 릴리스 리드와 sig-testing 및 기타 담당자가
|
||||
포함된다. 쿠버네티스 릴리스 프로세스에 대한 자세한 내용은
|
||||
[https://github.com/kubernetes/sig-release](https://github.com/kubernetes/sig-release)를
|
||||
참고한다.
|
||||
@@ -73,8 +74,8 @@ SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 쿠버네
|
||||
|
||||
## 새로운 기여자 홍보대사로 봉사
|
||||
|
||||
SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 새로운 기여자
|
||||
홍보대사로 활동할 수 있다.
|
||||
SIG Docs [승인자](/ko/docs/contribute/participate/roles-and-responsibilities/#승인자)는
|
||||
새로운 기여자 홍보대사로 활동할 수 있다.
|
||||
|
||||
새로운 기여자 홍보대사는 SIG-Docs에 기여한 새 기여자를 환영하고,
|
||||
새 기여자에게 PR을 제안하고, 첫 몇 번의 PR 제출을 통해
|
||||
@@ -92,12 +93,12 @@ SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 새로운
|
||||
|
||||
## 새로운 기여자 후원
|
||||
|
||||
SIG Docs [리뷰어](/ko/docs/contribute/participating/#리뷰어)는 새로운 기여자를
|
||||
후원할 수 있다.
|
||||
SIG Docs [리뷰어](/ko/docs/contribute/participate/roles-and-responsibilities/#리뷰어)는
|
||||
새로운 기여자를 후원할 수 있다.
|
||||
|
||||
새로운 기여자가 하나 이상의 쿠버네티스 리포지터리에 5개의
|
||||
실질적인 풀 리퀘스트를 성공적으로 제출한 후에는
|
||||
쿠버네티스 조직의 [멤버십](/ko/docs/contribute/participating#멤버)을
|
||||
쿠버네티스 조직의 [멤버십](/ko/docs/contribute/participate/roles-and-responsibilities/#멤버)을
|
||||
신청할 수 있다. 기여자의 멤버십은 이미 리뷰어인 두 명의 스폰서가
|
||||
후원해야 한다.
|
||||
|
||||
@@ -111,7 +112,8 @@ SIG Docs [리뷰어](/ko/docs/contribute/participating/#리뷰어)는 새로운
|
||||
|
||||
## SIG 공동 의장으로 봉사
|
||||
|
||||
SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 SIG Docs의 공동 의장 역할을 할 수 있다.
|
||||
SIG Docs [승인자](/ko/docs/contribute/participate/roles-and-responsibilities/#승인자)는
|
||||
SIG Docs의 공동 의장 역할을 할 수 있다.
|
||||
|
||||
### 전제 조건
|
||||
|
||||
@@ -120,7 +122,12 @@ SIG Docs [승인자](/ko/docs/contribute/participating/#승인자)는 SIG Docs
|
||||
- 6개월 이상 SIG Docs 승인자로 활동한다.
|
||||
- [쿠버네티스 문서 릴리스 주도](/ko/docs/contribute/advanced/#쿠버네티스-릴리스를-위한-문서-조정) 또는 두 개의 릴리스에서 섀도잉을 수행한다.
|
||||
- SIG Docs 워크플로와 툴링을 이해한다(git, Hugo, 현지화, 블로그 하위 프로젝트).
|
||||
- [k/org의 팀](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml), [k/community의 프로세스](https://github.com/kubernetes/community/tree/master/sig-docs), [k/test-infra](https://github.com/kubernetes/test-infra/)의 플러그인 및 [SIG 아키텍처](https://github.com/kubernetes/community/tree/master/sig-architecture)의 역할을 포함하여 다른 쿠버네티스 SIG와 리포지터리가 SIG Docs 워크플로에 미치는 영향을 이해한다.
|
||||
- [k/org의 팀](https://github.com/kubernetes/org/blob/master/config/kubernetes/sig-docs/teams.yaml),
|
||||
[k/community의 프로세스](https://github.com/kubernetes/community/tree/master/sig-docs),
|
||||
[k/test-infra](https://github.com/kubernetes/test-infra/)의 플러그인 및
|
||||
[SIG 아키텍처](https://github.com/kubernetes/community/tree/master/sig-architecture)의
|
||||
역할을 포함하여 다른 쿠버네티스 SIG와 리포지터리가 SIG Docs 워크플로에 미치는
|
||||
영향을 이해한다.
|
||||
- 최소 6개월 동안 일주일에 5시간 이상(대부분 더)을 역할에 책임진다.
|
||||
|
||||
### 책임
|
||||
|
||||
@@ -187,7 +187,7 @@ API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독
|
||||
|
||||
### 기능 게이트(feature gate) 한글화 방침
|
||||
|
||||
쿠버네티스의 [기능 게이트](/docs/reference/command-line-tools-reference/feature-gates/)를
|
||||
쿠버네티스의 [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를
|
||||
의미하는 용어는 한글화하지 않고 원문 형태를 유지한다.
|
||||
|
||||
기능 게이트의 예시는 다음과 같다.
|
||||
@@ -198,7 +198,7 @@ API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독
|
||||
- ...
|
||||
|
||||
전체 기능 게이트 목록은
|
||||
[여기](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates)를 참고한다.
|
||||
[여기](/ko/docs/reference/command-line-tools-reference/feature-gates/#feature-gates)를 참고한다.
|
||||
|
||||
{{% note %}}
|
||||
단, 해당 원칙에는 예외가 있을 수 있으며, 이 경우에는 가능한
|
||||
|
||||
@@ -1,6 +1,5 @@
|
||||
---
|
||||
title: 풀 리퀘스트 열기
|
||||
slug: new-content
|
||||
content_type: concept
|
||||
weight: 10
|
||||
card:
|
||||
|
||||
@@ -20,8 +20,12 @@ weight: 5
|
||||
- 마크다운(Markdown)으로 쿠버네티스 문서를 작성하고 [Hugo](https://gohugo.io/)를 사용하여 쿠버네티스 사이트를 구축한다.
|
||||
- 소스는 [GitHub](https://github.com/kubernetes/website)에 있다. 쿠버네티스 문서는 `/content/ko/docs/` 에서 찾을 수 있다. 일부 참조 문서는 `update-imported-docs/` 디렉터리의 스크립트에서 자동으로 생성된다.
|
||||
- [페이지 템플릿](/docs/contribute/style/page-content-types/)은 Hugo에서 문서 콘텐츠의 프리젠테이션을 제어한다.
|
||||
- 표준 Hugo 단축코드(shortcode) 이외에도 설명서에서 여러 [사용자 정의 Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 사용하여 콘텐츠 표시를 제어한다.
|
||||
- 문서 소스는 `/content/` 에서 여러 언어로 제공된다. 각 언어는 [ISO 639-1 표준](https://www.loc.gov/standards/iso639-2/php/code_list.php)에 의해 결정된 2문자 코드가 있는 자체 폴더가 있다. 예를 들어, 한글 문서의 소스는 `/content/ko/docs/` 에 저장된다.
|
||||
- 표준 Hugo 단축코드(shortcode) 이외에도 설명서에서 여러
|
||||
[사용자 정의 Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 사용하여 콘텐츠 표시를 제어한다.
|
||||
- 문서 소스는 `/content/` 에서 여러 언어로 제공된다. 각
|
||||
언어는 [ISO 639-1 표준](https://www.loc.gov/standards/iso639-2/php/code_list.php)에
|
||||
의해 결정된 2문자 코드가 있는 자체 폴더가 있다. 예를 들어,
|
||||
한글 문서의 소스는 `/content/ko/docs/` 에 저장된다.
|
||||
- 여러 언어로 문서화에 기여하거나 새로운 번역을 시작하는 방법에 대한 자세한 내용은 [현지화](/ko/docs/contribute/localization_ko/)를 참고한다.
|
||||
|
||||
## 시작하기 전에 {#before-you-begin}
|
||||
|
||||
@@ -20,7 +20,9 @@ SIG Docs는 모든 컨트리뷰터의 콘텐츠와 리뷰를 환영한다.
|
||||
누구나 풀 리퀘스트(PR)를 요청할 수 있고,
|
||||
누구나 콘텐츠에 대해 이슈를 등록하거나 진행 중인 풀 리퀘스트에 코멘트를 등록할 수 있다.
|
||||
|
||||
[멤버](/ko/docs/contribute/participating/roles-and-responsibilities/#멤버), [리뷰어](/ko/docs/contribute/participating/roles-and-responsibilities/#리뷰어), 또는 [승인자](/ko/docs/contribute/participating/roles-and-responsibilities/#승인자)가 될 수 있다.
|
||||
[멤버](/ko/docs/contribute/participate/roles-and-responsibilities/#멤버),
|
||||
[리뷰어](/ko/docs/contribute/participate/roles-and-responsibilities/#리뷰어), 또는
|
||||
[승인자](/ko/docs/contribute/participate/roles-and-responsibilities/#승인자)가 될 수 있다.
|
||||
이런 역할은 변경을 승인하고 커밋할 수 있도록 보다 많은 접근 권한과 이에 상응하는 책임이 수반된다.
|
||||
쿠버네티스 커뮤니티 내에서 멤버십이 운영되는 방식에 대한 보다 많은 정보를 확인하려면
|
||||
[커뮤니티 멤버십](https://github.com/kubernetes/community/blob/master/community-membership.md)
|
||||
@@ -30,8 +32,6 @@ SIG Docs는 모든 컨트리뷰터의 콘텐츠와 리뷰를 환영한다.
|
||||
문서를 관리하는 책임을 가지는 SIG Docs에서,
|
||||
이런 체계가 작동하는 특유의 방식에 대한 윤곽을 잡아보겠다.
|
||||
|
||||
|
||||
|
||||
<!-- body -->
|
||||
|
||||
## SIG Docs 의장
|
||||
@@ -58,7 +58,8 @@ GitHub의 SIG Docs [팀]에는 두 분류가 있다.
|
||||
그룹의 전원과 의사소통하기 위해서
|
||||
각각 GitHub 코멘트에서 그룹의 `@name`으로 참조할 수 있다.
|
||||
|
||||
가끔은 Prow와 GitHub 팀은 정확히 일치하지 않고 중복된다. 이슈, 풀 리퀘스트를 할당하고, PR 승인을 지원하기 위해서
|
||||
가끔은 Prow와 GitHub 팀은 정확히 일치하지 않고 중복된다.
|
||||
이슈, 풀 리퀘스트를 할당하고, PR 승인을 지원하기 위해서
|
||||
자동화 시스템이 `OWNERS` 파일의 정보를 활용한다.
|
||||
|
||||
### OWNERS 파일과 전문(front-matter)
|
||||
|
||||
@@ -6,7 +6,8 @@ weight: 10
|
||||
|
||||
<!-- overview -->
|
||||
|
||||
누구나 쿠버네티스에 기여할 수 있다. SIG Docs에 대한 기여가 커짐에 따라, 커뮤니티의 다양한 멤버십을 신청할 수 있다.
|
||||
누구나 쿠버네티스에 기여할 수 있다. SIG Docs에 대한 기여가 커짐에 따라,
|
||||
커뮤니티의 다양한 멤버십을 신청할 수 있다.
|
||||
이러한 역할을 통해 커뮤니티 내에서 더 많은 책임을 질 수 있다.
|
||||
각 역할마다 많은 시간과 노력이 필요하다. 역할은 다음과 같다.
|
||||
|
||||
@@ -23,10 +24,13 @@ GitHub 계정을 가진 누구나 쿠버네티스에 기여할 수 있다. SIG D
|
||||
|
||||
모든 사람은 다음의 작업을 할 수 있다.
|
||||
|
||||
- [`kubernetes/website`](https://github.com/kubernetes/website)를 포함한 모든 [쿠버네티스] 리포지터리에서 이슈를 올린다.
|
||||
- [`kubernetes/website`](https://github.com/kubernetes/website)를 포함한 모든
|
||||
[쿠버네티스](https://github.com/kubernetes/) 리포지터리에서
|
||||
이슈를 올린다.
|
||||
- 풀 리퀘스트에 대해 구속력 없는 피드백을 제공한다.
|
||||
- 현지화에 기여한다.
|
||||
- [슬랙](http://slack.k8s.io/) 또는 [SIG docs 메일링 리스트](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)에 개선을 제안한다.
|
||||
- [슬랙](http://slack.k8s.io/) 또는
|
||||
[SIG docs 메일링 리스트](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)에 개선을 제안한다.
|
||||
|
||||
[CLA에 서명](/ko/docs/contribute/new-content/overview/#sign-the-cla) 후에 누구나 다음을 할 수 있다.
|
||||
|
||||
@@ -37,16 +41,19 @@ GitHub 계정을 가진 누구나 쿠버네티스에 기여할 수 있다. SIG D
|
||||
|
||||
## 멤버
|
||||
|
||||
멤버는 `kubernetes/website` 에 여러 개의 풀 리퀘스트를 제출한 사람이다. 멤버는 [쿠버네티스 GitHub 조직](https://github.com/kubernetes)의 회원이다.
|
||||
멤버는 `kubernetes/website` 에 여러 개의 풀 리퀘스트를 제출한
|
||||
사람이다. 멤버는
|
||||
[쿠버네티스 GitHub 조직](https://github.com/kubernetes)의 회원이다.
|
||||
|
||||
멤버는 다음의 작업을 할 수 있다.
|
||||
|
||||
- [모든 사람](#모든-사람)에 나열된 모든 것을 한다.
|
||||
- 풀 리퀘스트에 `/lgtm` 코멘트를 사용하여 LGTM(looks good to me) 레이블을 추가한다.
|
||||
|
||||
{{< note >}}
|
||||
`/lgtm` 사용은 자동화를 트리거한다. 만약 구속력 없는 승인을 제공하려면, 단순히 "LGTM" 코멘트를 남기는 것도 좋다!
|
||||
{{< /note >}}
|
||||
{{< note >}}
|
||||
`/lgtm` 사용은 자동화를 트리거한다. 만약 구속력 없는 승인을 제공하려면, 단순히 "LGTM" 코멘트를 남기는 것도 좋다!
|
||||
{{< /note >}}
|
||||
|
||||
- `/hold` 코멘트를 사용하여 풀 리퀘스트에 대한 병합을 차단한다.
|
||||
- `/assign` 코멘트를 사용하여 풀 리퀘스트에 리뷰어를 지정한다.
|
||||
- 풀 리퀘스트에 구속력 없는 리뷰를 제공한다.
|
||||
@@ -55,46 +62,56 @@ GitHub 계정을 가진 누구나 쿠버네티스에 기여할 수 있다. SIG D
|
||||
|
||||
### 멤버 되기
|
||||
|
||||
최소 5개의 실질적인 풀 리퀘스트를 제출하고 다른 [요구 사항](https://github.com/kubernetes/community/blob/master/community-membership.md#member)을 충족시킨 후, 다음의 단계를 따른다.
|
||||
최소 5개의 실질적인 풀 리퀘스트를 제출하고 다른
|
||||
[요구 사항](https://github.com/kubernetes/community/blob/master/community-membership.md#member)을 충족시킨 후, 다음의 단계를 따른다.
|
||||
|
||||
1. 멤버십을 [후원](/docs/contribute/advanced#sponsor-a-new-contributor)해 줄 두 명의 [리뷰어](#리뷰어) 또는 [승인자](#승인자)를 찾는다.
|
||||
1. 멤버십을 [후원](/docs/contribute/advanced#sponsor-a-new-contributor)해줄 두 명의
|
||||
[리뷰어](#리뷰어) 또는 [승인자](#승인자)를
|
||||
찾는다.
|
||||
|
||||
[슬랙의 #sig-docs 채널](https://kubernetes.slack.com) 또는
|
||||
[SIG Docs 메일링 리스트](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)에서 후원을 요청한다.
|
||||
[슬랙의 #sig-docs 채널](https://kubernetes.slack.com) 또는
|
||||
[SIG Docs 메일링 리스트](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)에서 후원을 요청한다.
|
||||
|
||||
{{< note >}}
|
||||
SIG Docs 멤버 개인에게 직접 email을 보내거나
|
||||
슬랙 다이렉트 메시지를 보내지 않는다. 반드시 지원서를 제출하기 전에 후원을 요청해야 한다.
|
||||
{{< /note >}}
|
||||
{{< note >}}
|
||||
SIG Docs 멤버 개인에게 직접 email을 보내거나
|
||||
슬랙 다이렉트 메시지를 보내지 않는다. 반드시 지원서를 제출하기 전에 후원을 요청해야 한다.
|
||||
{{< /note >}}
|
||||
|
||||
2. [`kubernetes/org`](https://github.com/kubernetes/org/) 리포지터리에 GitHub 이슈를 등록한다. **Organization Membership Request** 이슈 템플릿을 사용한다.
|
||||
1. [`kubernetes/org`](https://github.com/kubernetes/org/) 리포지터리에
|
||||
GitHub 이슈를 등록한다.
|
||||
**Organization Membership Request** 이슈 템플릿을 사용한다.
|
||||
|
||||
3. 후원자에게 GitHub 이슈를 알린다. 다음 중 하나를 수행할 수 있다.
|
||||
- 이슈에서 후원자의 GitHub 사용자 이름을 코멘트로 추가한다. (`@<GitHub-username>`)
|
||||
- 슬랙 또는 이메일을 사용해 이슈 링크를 후원자에게 보낸다.
|
||||
1. 후원자에게 GitHub 이슈를 알린다. 다음 중 하나를 수행할 수 있다.
|
||||
- 이슈에서 후원자의 GitHub 사용자 이름을 코멘트로 추가한다. (`@<GitHub-username>`)
|
||||
- 슬랙 또는 이메일을 사용해 이슈 링크를 후원자에게 보낸다.
|
||||
|
||||
후원자는 `+1` 투표로 여러분의 요청을 승인할 것이다. 후원자가 요청을 승인하면, 쿠버네티스 GitHub 관리자가 여러분을 멤버로 추가한다. 축하한다!
|
||||
후원자는 `+1` 투표로 여러분의 요청을 승인할 것이다. 후원자가 요청을 승인하면,
|
||||
쿠버네티스 GitHub 관리자가 여러분을 멤버로 추가한다.
|
||||
축하한다!
|
||||
|
||||
만약 멤버십이 수락되지 않으면 피드백을 받게 될 것이다. 피드백의 내용을 해결한 후, 다시 지원하자.
|
||||
만약 멤버십이 수락되지 않으면 피드백을 받게 될 것이다. 피드백의 내용을 해결한 후, 다시 지원하자.
|
||||
|
||||
4. 여러분의 이메일 계정으로 수신된 쿠버네티스 GitHub 조직으로의 초대를 수락한다.
|
||||
1. 여러분의 이메일 계정으로 수신된 쿠버네티스 GitHub 조직으로의 초대를 수락한다.
|
||||
|
||||
{{< note >}}
|
||||
GitHub은 초대를 여러분 계정의 기본 이메일 주소로 보낸다.
|
||||
{{< /note >}}
|
||||
{{< note >}}
|
||||
GitHub은 초대를 여러분 계정의 기본 이메일 주소로 보낸다.
|
||||
{{< /note >}}
|
||||
|
||||
## 리뷰어
|
||||
|
||||
리뷰어는 열린 풀 리퀘스트를 리뷰할 책임이 있다. 멤버 피드백과는 달리, 여러분은 리뷰어의 피드백을 반드시 해결해야 한다. 리뷰어는 [@kubernetes/sig-docs-{language}-reviews](https://github.com/orgs/kubernetes/teams?query=sig-docs) GitHub 팀의 멤버이다.
|
||||
리뷰어는 열린 풀 리퀘스트를 리뷰할 책임이 있다. 멤버 피드백과는 달리,
|
||||
여러분은 리뷰어의 피드백을 반드시 해결해야 한다. 리뷰어는
|
||||
[@kubernetes/sig-docs-{language}-reviews](https://github.com/orgs/kubernetes/teams?query=sig-docs)
|
||||
GitHub 팀의 멤버이다.
|
||||
|
||||
리뷰어는 다음의 작업을 수행할 수 있다.
|
||||
|
||||
- [모든 사람](#모든-사람)과 [멤버](#멤버)에 나열된 모든 것을 수행한다.
|
||||
- 풀 리퀘스트 리뷰와 구속력 있는 피드백을 제공한다.
|
||||
|
||||
{{< note >}}
|
||||
구속력 없는 피드백을 제공하려면, 코멘트에 "선택 사항: "과 같은 문구를 접두어로 남긴다.
|
||||
{{< /note >}}
|
||||
{{< note >}}
|
||||
구속력 없는 피드백을 제공하려면, 코멘트에 "선택 사항: "과 같은 문구를 접두어로 남긴다.
|
||||
{{< /note >}}
|
||||
|
||||
- 코드에서 사용자 화면 문자열 편집
|
||||
- 코드 코멘트 개선
|
||||
@@ -107,37 +124,45 @@ GitHub 계정을 가진 누구나 쿠버네티스에 기여할 수 있다. SIG D
|
||||
[@_github_handle]` 코멘트를 남겨 특정 사람에게 리뷰를 요청할 수
|
||||
있다.
|
||||
|
||||
지정된 리뷰어가 PR에 코멘트를 남기지 않는다면, 다른 리뷰어가 개입할 수 있다. 필요에 따라 기술 리뷰어를 지정할 수도 있다.
|
||||
지정된 리뷰어가 PR에 코멘트를 남기지 않는다면, 다른 리뷰어가 개입할 수
|
||||
있다. 필요에 따라 기술 리뷰어를 지정할 수도 있다.
|
||||
|
||||
### `/lgtm` 사용하기
|
||||
|
||||
LGTM은 "Looks good to me"의 약자이며 풀 리퀘스트가 기술적으로 정확하고 병합할 준비가 되었음을 나타낸다. 모든 PR은 리뷰어의 `/lgtm` 코멘트가 필요하고 병합을 위해 승인자의 `/approve` 코멘트가 필요하다.
|
||||
LGTM은 "Looks good to me"의 약자이며 풀 리퀘스트가 기술적으로
|
||||
정확하고 병합할 준비가 되었음을 나타낸다. 모든 PR은 리뷰어의 `/lgtm` 코멘트가
|
||||
필요하고 병합을 위해 승인자의 `/approve` 코멘트가 필요하다.
|
||||
|
||||
리뷰어의 `/lgtm` 코멘트는 구속력 있고 자동화 시스템이 `lgtm` 레이블을 추가하도록 트리거한다.
|
||||
|
||||
### 리뷰어 되기
|
||||
|
||||
[요건](https://github.com/kubernetes/community/blob/master/community-membership.md#reviewer)을
|
||||
충족하면, SIG Docs 리뷰어가 될 수 있다. 다른 SIG의 리뷰어는 SIG Docs의 리뷰어 자격에 반드시 별도로 지원해야 한다.
|
||||
충족하면, SIG Docs 리뷰어가 될 수 있다. 다른 SIG의 리뷰어는 SIG Docs의 리뷰어 자격에
|
||||
반드시 별도로 지원해야 한다.
|
||||
|
||||
지원하려면, 다음을 수행한다.
|
||||
|
||||
1. `kubernetes/website` 리포지터리 내
|
||||
[OWNERS_ALIASES](https://github.com/kubernetes/website/blob/master/OWNERS) 파일의 섹션에
|
||||
여러분의 GitHub 사용자 이름을 추가하는 풀 리퀘스트를 연다.
|
||||
[OWNERS_ALIASES](https://github.com/kubernetes/website/blob/master/OWNERS) 파일의 섹션에
|
||||
여러분의 GitHub 사용자 이름을 추가하는 풀 리퀘스트를 연다.
|
||||
|
||||
{{< note >}}
|
||||
자신을 추가할 위치가 확실하지 않으면, `sig-docs-ko-reviews` 에 추가한다.
|
||||
{{< /note >}}
|
||||
|
||||
2. PR을 하나 이상의 SIG-Docs 승인자(`sig-docs-{language}-owners` 에 나열된 사용자 이름)에게 지정한다.
|
||||
1. PR을 하나 이상의 SIG-Docs 승인자(`sig-docs-{language}-owners` 에
|
||||
나열된 사용자 이름)에게 지정한다.
|
||||
|
||||
승인되면, SIG Docs 리더가 적당한 GitHub 팀에 여러분을 추가한다. 일단 추가되면, [K8s-ci-robot](https://github.com/kubernetes/test-infra/tree/master/prow#bots-home)이 새로운 풀 리퀘스트에서 리뷰어로 여러분을 할당하고 제안한다.
|
||||
승인되면, SIG Docs 리더가 적당한 GitHub 팀에 여러분을 추가한다. 일단 추가되면,
|
||||
[K8s-ci-robot](https://github.com/kubernetes/test-infra/tree/master/prow#bots-home)이
|
||||
새로운 풀 리퀘스트에서 리뷰어로 여러분을 할당하고 제안한다.
|
||||
|
||||
## 승인자
|
||||
|
||||
승인자는 병합하기 위해 풀 리퀘스트를 리뷰하고 승인한다. 승인자는
|
||||
[@kubernetes/sig-docs-{language}-owners](https://github.com/orgs/kubernetes/teams/?query=sig-docs) GitHub 팀의 멤버이다.
|
||||
[@kubernetes/sig-docs-{language}-owners](https://github.com/orgs/kubernetes/teams/?query=sig-docs)
|
||||
GitHub 팀의 멤버이다.
|
||||
|
||||
승인자는 다음의 작업을 할 수 있다.
|
||||
|
||||
@@ -147,22 +172,27 @@ LGTM은 "Looks good to me"의 약자이며 풀 리퀘스트가 기술적으로
|
||||
- 문서 테스트 개선을 제안한다.
|
||||
- 쿠버네티스 웹사이트 또는 다른 도구 개선을 제안한다.
|
||||
|
||||
PR에 이미 `/lgtm` 이 있거나, 승인자도 `/lgtm` 코멘트를 남긴다면, PR은 자동으로 병합된다. SIG Docs 승인자는 추가적인 기술 리뷰가 필요치 않는 변경에 대해서만 `/lgtm` 을 남겨야 한다.
|
||||
PR에 이미 `/lgtm` 이 있거나, 승인자도 `/lgtm` 코멘트를 남긴다면,
|
||||
PR은 자동으로 병합된다. SIG Docs 승인자는 추가적인 기술 리뷰가 필요치 않는 변경에 대해서만
|
||||
`/lgtm` 을 남겨야 한다.
|
||||
|
||||
|
||||
### 풀 리퀘스트 승인
|
||||
|
||||
승인자와 SIG Docs 리더는 website 리포지터리로 풀 리퀘스트를 병합할 수 있는 유일한 사람들이다. 이것은 특정한 책임이 따른다.
|
||||
승인자와 SIG Docs 리더는 website 리포지터리로 풀 리퀘스트를 병합할 수 있는
|
||||
유일한 사람들이다. 이것은 특정한 책임이 따른다.
|
||||
|
||||
- 승인자는 PR들을 리포지터리에 병합하는 `/approve` 명령을 사용할 수 있다.
|
||||
|
||||
{{< warning >}}
|
||||
부주의한 머지로 인해 사이트를 파괴할 수 있으므로, 머지할 때에 그 의미를 확인해야 한다.
|
||||
{{< /warning >}}
|
||||
{{< warning >}}
|
||||
부주의한 머지로 인해 사이트를 파괴할 수 있으므로, 머지할 때에 그 의미를 확인해야 한다.
|
||||
{{< /warning >}}
|
||||
|
||||
- 제안된 변경이 [컨트리뷰션 가이드 라인](/docs/contribute/style/content-guide/#contributing-content)에 적합한지 확인한다.
|
||||
- 제안된 변경이
|
||||
[컨트리뷰션 가이드 라인](/docs/contribute/style/content-guide/#contributing-content)에 적합한지 확인한다.
|
||||
|
||||
질문이 생기거나 확실하지 않다면 자유롭게 추가 리뷰를 요청한다.
|
||||
질문이 생기거나 확실하지 않다면 자유롭게
|
||||
추가 리뷰를 요청한다.
|
||||
|
||||
- PR을 `/approve` 하기 전에 Netlify 테스트 결과를 검토한다.
|
||||
|
||||
@@ -170,17 +200,24 @@ PR에 이미 `/lgtm` 이 있거나, 승인자도 `/lgtm` 코멘트를 남긴다
|
||||
|
||||
- 승인 전에 PR에 대한 Netlify 프리뷰 페이지를 방문하여, 제대로 보이는지 확인한다.
|
||||
|
||||
- 주간 로테이션을 위해 [PR Wrangler 로테이션 스케줄](https://github.com/kubernetes/website/wiki/PR-Wranglers)에 참여한다. SIG Docs는 모든 승인자들이 이 로테이션에 참여할
|
||||
것으로 기대한다. 자세한 내용은 [PR 랭글러(PR wrangler)](/ko/docs/contribute/participating/pr-wranglers/)를
|
||||
참고한다.
|
||||
- 주간 로테이션을 위해
|
||||
[PR Wrangler 로테이션 스케줄](https://github.com/kubernetes/website/wiki/PR-Wranglers)에
|
||||
참여한다. SIG Docs는 모든 승인자들이 이 로테이션에 참여할 것으로 기대한다. 자세한 내용은
|
||||
[PR 랭글러(PR wrangler)](/ko/docs/contribute/participating/pr-wranglers/)를
|
||||
참고한다.
|
||||
|
||||
## 승인자 되기
|
||||
|
||||
[요구 사항](https://github.com/kubernetes/community/blob/master/community-membership.md#approver)을 충족하면 SIG Docs 승인자가 될 수 있다. 다른 SIG의 승인자는 SIG Docs의 승인자 자격에 대해 별도로 신청해야 한다.
|
||||
[요구 사항](https://github.com/kubernetes/community/blob/master/community-membership.md#approver)을
|
||||
충족하면 SIG Docs 승인자가 될 수 있다.
|
||||
다른 SIG의 승인자는 SIG Docs의 승인자 자격에 대해
|
||||
별도로 신청해야 한다.
|
||||
|
||||
지원하려면 다음을 수행한다.
|
||||
|
||||
1. `kubernetes/website` 리포지터리 내 [OWNERS_ALIASES](https://github.com/kubernetes/website/blob/master/OWNERS) 파일의 섹션에 자신을 추가하는 풀 리퀘스트를 연다.
|
||||
1. `kubernetes/website` 리포지터리 내
|
||||
[OWNERS_ALIASES](https://github.com/kubernetes/website/blob/master/OWNERS)
|
||||
파일의 섹션에 자신을 추가하는 풀 리퀘스트를 연다.
|
||||
|
||||
{{< note >}}
|
||||
자신을 추가할 위치가 확실하지 않으면, `sig-docs-ko-owners` 에 추가한다.
|
||||
@@ -188,7 +225,9 @@ PR에 이미 `/lgtm` 이 있거나, 승인자도 `/lgtm` 코멘트를 남긴다
|
||||
|
||||
2. PR에 한 명 이상의 현재 SIG Docs 승인자를 지정한다.
|
||||
|
||||
승인되면, SIG Docs 리더가 적당한 GitHub 팀에 여러분을 추가한다. 일단 추가되면, [@k8s-ci-robot](https://github.com/kubernetes/test-infra/tree/master/prow#bots-home)이 새로운 풀 리퀘스트에서 승인자로 여러분을 할당하고 제안한다.
|
||||
승인되면, SIG Docs 리더가 적당한 GitHub 팀에 여러분을 추가한다. 일단 추가되면,
|
||||
[@k8s-ci-robot](https://github.com/kubernetes/test-infra/tree/master/prow#bots-home)이
|
||||
새로운 풀 리퀘스트에서 승인자로 여러분을 할당하고 제안한다.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
|
||||
@@ -8,7 +8,9 @@ weight: 20
|
||||
|
||||
<!-- overview -->
|
||||
|
||||
SIG Docs [리뷰어](/ko/docs/contribute/participating/#리뷰어)와 [승인자](/ko/docs/contribute/participating/#승인자)는 변경 사항을 리뷰할 때 몇 가지 추가 작업을 수행한다.
|
||||
SIG Docs [리뷰어](/ko/docs/contribute/participate/roles-and-responsibilities/#리뷰어)와
|
||||
[승인자](/ko/docs/contribute/participate/roles-and-responsibilities/#승인자)는 변경 사항을
|
||||
리뷰할 때 몇 가지 추가 작업을 수행한다.
|
||||
|
||||
매주 특정 문서 승인자 역할의 지원자가
|
||||
풀 리퀘스트를 심사하고 리뷰한다. 이
|
||||
@@ -19,9 +21,6 @@ SIG Docs [리뷰어](/ko/docs/contribute/participating/#리뷰어)와 [승인자
|
||||
로테이션 외에도, 봇은 영향을 받는 파일의 소유자를 기반으로
|
||||
PR에 대한 리뷰어와 승인자를 할당한다.
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- body -->
|
||||
|
||||
## PR 리뷰
|
||||
@@ -201,9 +200,9 @@ SIG Docs가 처리 방법을 문서화할 정도로 다음과 같은 유형의
|
||||
```none
|
||||
이 이슈는 지원 요청과 비슷하지만
|
||||
문서 관련 이슈와는 관련이 없는 것 같습니다.
|
||||
[쿠버네티스 슬랙](http://slack.k8s.io/)의
|
||||
[쿠버네티스 슬랙](https://slack.k8s.io/)의
|
||||
`#kubernetes-users` 채널에서 질문을 하시기 바랍니다. 또한,
|
||||
[Stack Overflow](http://stackoverflow.com/questions/tagged/kubernetes)와
|
||||
[Stack Overflow](https://stackoverflow.com/questions/tagged/kubernetes)와
|
||||
같은 리소스를 검색하여 유사한 질문에 대한 답변을
|
||||
얻을 수도 있습니다.
|
||||
|
||||
|
||||
@@ -16,10 +16,9 @@ weight: 10
|
||||
리뷰하기 전에, 다음을 수행하는 것이 좋다.
|
||||
|
||||
- 적합한 코멘트를 남길 수 있도록 [콘텐츠 가이드](/docs/contribute/style/content-guide/)와
|
||||
[스타일 가이드](/docs/contribute/style/style-guide/)를 읽는다.
|
||||
- 쿠버네티스 문서화 커뮤니티의 다양한 [역할과 책임](/ko/docs/contribute/participating/#역할과-책임)을 이해한다.
|
||||
|
||||
|
||||
[스타일 가이드](/docs/contribute/style/style-guide/)를 읽는다.
|
||||
- 쿠버네티스 문서화 커뮤니티의 다양한
|
||||
[역할과 책임](/ko/docs/contribute/participating/#역할과-책임)을 이해한다.
|
||||
|
||||
<!-- body -->
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ weight: 20
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
[기여 시작하기](/docs/contribute/start/)에 설명된 대로 쿠버네티스
|
||||
[PR 열기](/ko/docs/contribute/new-content/open-a-pr/)에 설명된 대로 쿠버네티스
|
||||
문서 저장소의 포크(fork)를 생성하자.
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user