Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate "docs" menu as Korean #904

Merged
merged 3 commits into from
Oct 3, 2016
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
98 changes: 98 additions & 0 deletions locale/ko/docs/es6.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
---
title: ECMAScript 2015(ES6)와 그 다음
layout: docs.hbs
---
<!--
# ECMAScript 2015 (ES6) and beyond

Node.js is built against modern versions of [V8](https://developers.google.com/v8/). By keeping up-to-date with the latest releases of this engine, we ensure new features from the [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) are brought to Node.js developers in a timely manner, as well as continued performance and stability improvements.

All ECMAScript 2015 (ES6) features are split into three groups for **shipping**, **staged**, and **in progress** features:

* All **shipping** features, which V8 considers stable, are turned **on by default on Node.js** and do **NOT** require any kind of runtime flag.
* **Staged** features, which are almost-completed features that are not considered stable by the V8 team, require a runtime flag: `--harmony`.
* **In progress** features can be activated individually by their respective harmony flag, although this is highly discouraged unless for testing purposes. Note: these flags are exposed by V8 and will potentially change without any deprecation notice.
-->
Copy link
Contributor

@marocchino marocchino Sep 22, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It will be safer add blank line around comment blocks. (unless you checked all pages.)
Some parser dose not handle this blocks properly.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree with you even though I checked all pages.

# ECMAScript 2015(ES6)와 그 다음

Node.js는 [V8](https://developers.google.com/v8/)의 최신 버전으로 만들었습니다.
V8을 최신 릴리스로 유지하기 때문에 Node.js 개발자에게
[JavaScript ECMA-262 명세](http://www.ecma-international.org/publications/standards/Ecma-262.htm)의
새로운 기능을 제때에 지원하면서 성능과 안정성 개선도 할 수 있습니다.

모든 ECMAScript 2015(ES6) 기능은 **shipping**, **staged**, **in progress** 기능의
세 가지 그룹으로 나뉩니다.

* 모든 **shipping** 기능은 V8이 안정적이라고 간주한 것으로
**Node.js에서는 기본적으로 켜져 있으므로** 런타임 플래그가 전혀 **필요 없습니다**.
* **Staged** 기능은 거의 완성되었지만, V8 팀이 안정적이라고 간주하지 않은 기능으로
`--harmony` 런타임 플래그가 필요합니다.
* **In progress** 기능은 각 하모니 플래그로 개별적으로 활성화할 수 있습니다. 테스트 목적이
아니라면 활성화하지 않기를 강력하게 권장한다. Note: 이 플래그는 V8에서 제공한 것으로
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(for consistency)
권장한다 -> 권장합니다

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

권장한다 > 권장합니다.
Note: > 주의:

폐기 공지 없이 변경될 수 있습니다.

<!--
## Which features ship with which Node.js version by default?

The website [node.green](http://node.green) provides an excellent overview over supported ECMAScript features in various versions of Node.js, based on kangax's compat-table.
-->
## Node.js 버전에 어떤 기능이 기본적으로 포함되나요?

[node.green](http://node.green) 웹사이트에서 Node.js의 다양한 버전에서 지원하는
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence has two 에서. I think it is confuse to someone.
How about this:

kangax의 호환성 표를 기반으로 만들어진 node.green 웹사이트에서 어떤 Node.js가 어떤 ECMAScript 기능을 지원하는지 쉽게..

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이쪽 저장소지만 한글로 쓰셔도 될꺼라고 생각합니다. 한국어 리뷰라서요...(왠지 힘드시지 않을까 싶어서.)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

..음.. 그럴까요?;

ECMAScript 기능을 쉽게 파악할 수 있습니다. 이는 kangax의 호환성 표를 기반으로 만들어졌습니다.

<!--
## Which features are in progress?

New features are constantly being added to the V8 engine. Generally speaking, expect them to land on a future Node.js release, although timing is unknown.

You may list all the *in progress* features available on each Node.js release by grepping through the `--v8-options` argument. Please note that these are incomplete and possibly broken features of V8, so use them at your own risk:

```bash
node --v8-options | grep "in progress"
```
-->
## 어떤 기능이 진행 중입니까?

V8 엔진에 계속해서 새로운 기능이 들어가고 있습니다. 대략 말하자면 시기는 알 수 없어도
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

들어가고 > 추가되고
로 변경하는 편이 더 자연스럽게 들릴 듯 합니다.

미래의 Node.js 릴리스에는 이 기능들이 들어온다고 할 수 있습니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

정확한 시기는 알 수 없겠지만 앞으로 릴리스 할 Node.js에는 V8에 추가된 새 기능이 대체로 포함될 것입니다.


`--v8-options` 인자로 각 Node.js 릴리스에서 모든 *in progress* 기능의 리스트를 볼 수
있습니다. 이 기능들은 완성되지 않았고 V8에서 제대로 돌아가지 않을 수도 있으므로 이 기능을 사용할 때는
위험을 고려해야 함을 명심하세요.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

위험을 고려해야 -> 위험을 감수해야


```bash
node --v8-options | grep "in progress"
```

<!--
## I have my infrastructure set up to leverage the --harmony flag. Should I remove it?

The current behaviour of the `--harmony` flag on Node.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on Node.js. If you keep this enabled, you should be prepared for further Node.js upgrades to break your code if V8 changes their semantics to more closely follow the standard.
-->
## --harmony 플래그를 사용하는 환경이 있습니다. 이를 제거해야 하나요?

Node.js에서 `--harmony` 플래그의 현재 동작은 **staged** 기능만 활성화하는 것입니다. 결국,
이는 `--es_staging`와 같은 의미입니다. 앞에서 말했듯이 이 기능은 완성되었지만, 아직 안정적이라고
간주하지 않은 것입니다. 프로덕션 환경 등에서 안전하게 운영하고 싶다면 V8과 Node.js에서 기본적으로
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

아직 안정적이라고 간주하지 않은 것입니다

How about '아직 안정적이라고 볼 수는 없습니다'?

제공할 때까지 이 런타임 플래그를 제거하는 것을 고려해 보세요. 이 기능을 활성화한다면 차후 Node.js를
업그레이드 할 때 V8이 이 기능의 의미를 표준에 더 가깝게 변경한 경우 코드가 깨질 수 있으므로
대비해야 합니다.

<!--
## How do I find which version of V8 ships with a particular version of Node.js?

Node.js provides a simple way to list all dependencies and respective versions that ship with a specific binary through the `process` global object. In case of the V8 engine, type the following in your terminal to retrieve its version:

```bash
node -p process.versions.v8
```
-->
## Node.js의 특정 버전에 포함된 V8의 버전을 어떻게 알 수 있나요?

Node.js에서는 `process` 전역 객체를 통해 특정 바이너리에 포함된 모든 의존성과 각 버전의 목록을
쉽게 볼 수 있습니다. V8 엔진의 경우 터미널에서 다음 명령어를 실행하면 V8 버전을 볼 수 있습니다.

```bash
node -p process.versions.v8
```
48 changes: 48 additions & 0 deletions locale/ko/docs/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: FAQ
layout: docs.hbs
---
<!--
# FAQ

## How can I contribute?

Everyone can help. Node.js adheres to a [code of conduct](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-of-conduct), and contributions, releases, and contributorship are under an [open governance](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme) model.

To get started, there are open [discussions on GitHub](https://github.com/nodejs/node/issues), and we'd love to hear your feedback. Becoming involved in discussions is a good way to get a feel of where you can help out further. If there is something there you feel you can tackle, please [make a pull request](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-contributions).
-->
# FAQ

## 어떻게 기여하나요?

누구나 참여할 수 있습니다. Node.js는
[행동 강령](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-of-conduct)을
지키고 [오픈 거버넌스](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme)
모델 하에 기여, 릴리스, 기여자를 운영합니다.

[GitHub에 공개적으로 논의](https://github.com/nodejs/node/issues)를 하고 있고 우리는
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

말이 조금 어색해서 살짝 의역해보았습니다.

우선은 GitHub에서 공개적으로 이뤄지는 논의에 참여해보는 것도 좋습니다. 우리는 여러분의 피드백을 듣고 싶습니다.

피드백을 듣기 원합니다. 논의에 참여하는 것은 무엇을 도울 수 있는지 찾는 좋은 방법입니다. 기여할 수 있는
부분은 찾았다면
[풀 리퀘스트를 올려주세요](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-contributions).

<!--
## Where do discussions take place?

There is an #node.js channel on Freenode IRC. We keep logs of the channel [here](http://logs.libuv.org/node.js/latest).
-->
## 논의는 어디서 이뤄지나요?

Freenode IRC에 #node.js 채널이 있습니다. 채널의 대화 로그를
[여기](http://logs.libuv.org/node.js/latest)에 저장해 두고 있습니다.

<!--
## What is open source governance?

Open source governance advocates the application of the philosophies of the open source and open content movements in order to enable any interested party to add to the creation of the end product, as with a wiki document. Legislation is democratically opened to the general citizenry, employing their collective wisdom to benefit the decision-making process and improve democracy. [[source]](https://en.wikipedia.org/wiki/Open-source_governance)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the democracy noun here? -3-
Weird.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

의미는 "더 민주적으로 된다"정도로 이해했는데 좀더 좋은 문장이 있을까요?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

네 의미상 부사일거라 생각했는데, democracy는 명사밖에 없네요. 이상하긴한데 변역은 틀리지 않은것 같습니다.

-->
## 오픈 소스 거버넌스가 무엇인가요?

오픈 소스 거버넌스는 위키 문서처럼 관심 있는 사람이라면 누구나 최종 제품에 창작물을 추가할 수 있도록
오픈 소스와 오픈 콘텐츠 운동의 철학을 지지합니다. 규칙은 모든 사람에게 민주적으로 열려있고 이들의
집단 지성을 모아서 의사결정 과정을 돕고 민주주의를 개선합니다.
[[출처]](https://en.wikipedia.org/wiki/Open-source_governance)
Loading