Skip to content

Commit a3666a7

Browse files
committed
Update contribute/new-content of 1.22-ko.2
1 parent 90fe3d1 commit a3666a7

File tree

4 files changed

+66
-67
lines changed

4 files changed

+66
-67
lines changed
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,64 @@
11
---
22
title: 새로운 콘텐츠 기여하기
3+
content_type: concept
4+
main_menu: true
35
weight: 20
46
---
7+
8+
<!-- overview -->
9+
10+
이 섹션에는 새로운 콘텐츠를 기여하기 전에 알아야 할 정보가 있다.
11+
12+
13+
14+
15+
<!-- body -->
16+
17+
## 기여에 대한 기본 사항
18+
19+
- 마크다운(Markdown)으로 쿠버네티스 문서를 작성하고 [Hugo](https://gohugo.io/)를 사용하여 쿠버네티스 사이트를 구축한다.
20+
- 소스는 [GitHub](https://github.com/kubernetes/website)에 있다. 쿠버네티스 문서는 `/content/ko/docs/` 에서 찾을 수 있다. 일부 참조 문서는 `update-imported-docs/` 디렉터리의 스크립트에서 자동으로 생성된다.
21+
- [페이지 템플릿](/docs/contribute/style/page-content-types/)은 Hugo에서 문서 콘텐츠의 프리젠테이션을 제어한다.
22+
- 표준 Hugo 단축코드(shortcode) 이외에도 설명서에서 여러
23+
[사용자 정의 Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 사용하여 콘텐츠 표시를 제어한다.
24+
- 문서 소스는 `/content/` 에서 여러 언어로 제공된다. 각
25+
언어는 [ISO 639-1 표준](https://www.loc.gov/standards/iso639-2/php/code_list.php)
26+
의해 결정된 2문자 코드가 있는 자체 폴더가 있다. 예를 들어,
27+
한글 문서의 소스는 `/content/ko/docs/` 에 저장된다.
28+
- 여러 언어로 문서화에 기여하거나 새로운 번역을 시작하는 방법에 대한 자세한 내용은 [현지화](/ko/docs/contribute/localization_ko/)를 참고한다.
29+
30+
## 시작하기 전에 {#before-you-begin}
31+
32+
### CNCF CLA 서명 {#sign-the-cla}
33+
34+
모든 쿠버네티스 기여자는 **반드시** [기여자 가이드](https://github.com/kubernetes/community/blob/master/contributors/guide/README.md)를 읽고 [기여자 라이선스 계약(CLA)에 서명](https://github.com/kubernetes/community/blob/master/CLA.md)해야 한다.
35+
36+
CLA에 서명하지 않은 기여자의 풀 리퀘스트(pull request)는 자동 테스트에 실패한다. 제공한 이름과 이메일은 `git config` 에 있는 것과 일치해야 하며, git 이름과 이메일은 CNCF CLA에 사용된 것과 일치해야 한다.
37+
38+
### 사용할 Git 브랜치를 선택한다
39+
40+
풀 리퀘스트를 열 때는, 작업의 기반이 되는 브랜치를 미리 알아야 한다.
41+
42+
시나리오 | 브랜치
43+
:---------|:------------
44+
현재 릴리스의 기존 또는 새로운 영어 콘텐츠 | `main`
45+
기능 변경 릴리스의 콘텐츠 | `dev-<version>` 패턴을 사용하여 기능 변경이 있는 주 버전과 부 버전에 해당하는 브랜치. 예를 들어, `v{{< skew nextMinorVersion >}}` 에서 기능이 변경된 경우, ``dev-{{< skew nextMinorVersion >}}`` 에 문서 변경을 추가한다.
46+
다른 언어로된 콘텐츠(현지화) | 현지화 규칙을 사용. 자세한 내용은 [현지화 브랜치 전략](/docs/contribute/localization/#branching-strategy)을 참고한다.
47+
48+
49+
어떤 브랜치를 선택해야 할지 잘 모르는 경우 슬랙의 `#sig-docs` 에 문의한다.
50+
51+
{{< note >}}
52+
풀 리퀘스트를 이미 제출했는데 기본 브랜치가 잘못되었다는 것을 알게 되면,
53+
제출자(제출자인 여러분만)가 이를 변경할 수 있다.
54+
{{< /note >}}
55+
56+
### PR 당 언어
57+
58+
PR 당 하나의 언어로 풀 리퀘스트를 제한한다. 여러 언어로 동일한 코드 샘플을 동일하게 변경해야 하는 경우 각 언어마다 별도의 PR을 연다.
59+
60+
## 기여자를 위한 도구들
61+
62+
`kubernetes/website` 리포지터리의 [문서 기여자를 위한 도구](https://github.com/kubernetes/website/tree/main/content/en/docs/doc-contributor-tools) 디렉터리에는 기여 여정을 좀 더 순조롭게 도와주는 도구들이 포함되어 있다.
63+
64+

content/ko/docs/contribute/new-content/overview.md

Lines changed: 0 additions & 65 deletions
This file was deleted.

content/ko/docs/home/_index.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
---
2+
3+
24
title: 쿠버네티스 문서
35
noedit: true
46
cid: docsHome
@@ -20,9 +22,9 @@ overview: >
2022
쿠버네티스는 배포, 스케일링, 그리고 컨테이너화된 애플리케이션의 관리를 자동화 해주는 오픈 소스 컨테이너 오케스트레이션 엔진이다. 본 오픈 소스 프로젝트는 Cloud Native Computing Foundation(<a href="https://www.cncf.io/about">CNCF</a>)가 주관한다.
2123
cards:
2224
- name: concepts
23-
title: "기초 이해하기"
25+
title: "쿠버네티스 이해하기"
2426
description: "쿠버네티스와 쿠버네티스의 기본 개념을 배운다."
25-
button: "개념 배우기"
27+
button: "개념 살펴보기"
2628
button_path: "/ko/docs/concepts"
2729
- name: tutorials
2830
title: "쿠버네티스 사용해보기"

content/ko/docs/reference/_index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,8 @@ TCP/UDP 스트림 포워딩이나 백-엔드 집합에 걸쳐서 라운드-로
6464
* [kube-scheduler 정책](/ko/docs/reference/scheduling/policies)
6565
* [kube-scheduler 프로파일](/ko/docs/reference/scheduling/config/#여러-프로파일)
6666

67+
* 컨트롤 플레인과 워커 노드에서 꼭 열어야 하는
68+
[포트와 프로토콜](/docs/reference/ports-and-protocols/) 리스트
6769
## API 설정
6870

6971
이 섹션은 쿠버네티스 구성요소 또는 도구를 환경설정하는 데에 사용되는

0 commit comments

Comments
 (0)