From 449d88673bb5fce1e1210f79da6c90c5a48b13f9 Mon Sep 17 00:00:00 2001 From: jesse Date: Sat, 2 Feb 2019 12:23:48 +0900 Subject: [PATCH 1/7] docs: translate try-react --- content/docs/getting-started.md | 41 ++++++++++++++++++--------------- 1 file changed, 23 insertions(+), 18 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 8ad77b1ac..5682c4d82 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -18,39 +18,44 @@ redirect_from: - "docs/environments.html" --- -This page is an overview of the React documentation and related resources. +このページは React のドキュメント、および関連する資料の概要となります。 -**React** is a JavaScript library for building user interfaces. Learn what React is all about on [our homepage](/) or [in the tutorial](/tutorial/tutorial.html). +**React** はユーザーインターフェースを作成する為の JavaScript のライブラリです。 +[ここのホームページ](/)、または[このチュートリアル](/tutorial/tutorial.html)から React がどういうものかを学びましょう。 --- -- [Try React](#try-react) -- [Learn React](#learn-react) -- [Staying Informed](#staying-informed) -- [Versioned Documentation](#versioned-documentation) -- [Something Missing?](#something-missing) +- [React を試す](#try-react) +- [React を学ぶ](#learn-react) +- [最新の情報を追う](#staying-informed) +- [バージョン管理されたドキュメント](#versioned-documentation) +- [足りないものがある?](#something-missing) -## Try React +## React を試す -React has been designed from the start for gradual adoption, and **you can use as little or as much React as you need.** Whether you want to get a taste of React, add some interactivity to a simple HTML page, or start a complex React-powered app, the links in this section will help you get started. +React は初めから既存のプロジェクトに徐々に追加していけるようなデザインとなっています。 **あなたは React をどれだけ使っても問題ありません**触りだけやってみるもよし、シンプルな HTML のページにインタラクティブな機能を追加するのに使うもよし、React をフル活用した複雑なアプリを作成するもよし。どのような目的にしても、このページにあるリンクが役に立つでしょう。 -### Online Playgrounds +### Web 上で試す -If you're interested in playing around with React, you can use an online code playground. Try a Hello World template on [CodePen](codepen://hello-world) or [CodeSandbox](https://codesandbox.io/s/new). +React を試してみたかったら、Web 上のコードエディタでも試すことができます。 +[CodePen](codepen://hello-world) や [CodeSandbox](https://codesandbox.io/s/new) で Hello World のテンプレートを使って試してみましょう。 -If you prefer to use your own text editor, you can also [download this HTML file](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), edit it, and open it from the local filesystem in your browser. It does a slow runtime code transformation, so we'd only recommend using this for simple demos. +自前のテキストエディタを使いたい場合は、[この HTML ファイル](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)をダウンロードして、編集して、ブラウザからローカルで開くことができます。 +ランタイムでのコード変換が行われる為、簡単なデモに留めておくことをおすすめします。 -### Add React to a Website +### React を Web サイトに追加する -You can [add React to an HTML page in one minute](/docs/add-react-to-a-website.html). You can then either gradually expand its presence, or keep it contained to a few dynamic widgets. +[React は HTML ページにすぐに追加することができます。](/docs/add-react-to-a-website.html) 追加したら、徐々に全体に反映させていくか、数量のダイナミックなウィジェットに留めるかはあなたの自由です。 -### Create a New React App +### 新規 React アプリの作成 -When starting a React project, [a simple HTML page with script tags](/docs/add-react-to-a-website.html) might still be the best option. It only takes a minute to set up! +新しく React のプロジェクトを始めたい場合でも、まずは[シンプルな HTML ページに script タグを追加](/docs/add-react-to-a-website.html)するのがおすすめです。数分でセットアップできます！ -As your application grows, you might want to consider a more integrated setup. There are [several JavaScript toolchains](/docs/create-a-new-react-app.html) we recommend for larger applications. Each of them can work with little to no configuration and lets you take full advantage of the rich React ecosystem. +アプリが成長するにつれて、より統合されたセットアップを行うことを考慮していきましょう。 +大きいアプリの為には我々が勧める [様々なJavaScript を用いたツールチェイン](/docs/create-a-new-react-app.html)が存在します。 +それぞれ少ない設定、もしくは設定要らずでリッチな React のエコシステムを活用していくことができます。 -## Learn React +## React を学ぶ People come to React from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. From f2f7714af9d9c40905886339990b2677766b6b92 Mon Sep 17 00:00:00 2001 From: jesse Date: Mon, 4 Feb 2019 23:58:17 +0900 Subject: [PATCH 2/7] docs: translate getting-started.md --- content/docs/getting-started.md | 86 ++++++++++++++++++--------------- 1 file changed, 48 insertions(+), 38 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 5682c4d82..f43876b87 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -27,13 +27,13 @@ redirect_from: - [React を試す](#try-react) - [React を学ぶ](#learn-react) -- [最新の情報を追う](#staying-informed) +- [最新の情報を追いたい人へ](#staying-informed) - [バージョン管理されたドキュメント](#versioned-documentation) - [足りないものがある?](#something-missing) ## React を試す -React は初めから既存のプロジェクトに徐々に追加していけるようなデザインとなっています。 **あなたは React をどれだけ使っても問題ありません**触りだけやってみるもよし、シンプルな HTML のページにインタラクティブな機能を追加するのに使うもよし、React をフル活用した複雑なアプリを作成するもよし。どのような目的にしても、このページにあるリンクが役に立つでしょう。 +React は初めから既存のプロジェクトに徐々に追加していけるようなデザインとなっています。 **あなたは React をどれだけ使っても問題ありません。** 触りだけやってみるもよし、シンプルな HTML のページにインタラクティブな機能を追加するのに使うもよし、React をフル活用した複雑なアプリを作成するもよし。どのような目的にしても、このページにあるリンクが役に立つでしょう。 ### Web 上で試す @@ -57,75 +57,85 @@ React を試してみたかったら、Web 上のコードエディタでも試 ## React を学ぶ -People come to React from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. +React を学びたい人には様々な背景があり、それぞれいろんな学び方のスタイルがあるでしょう。 +理論から学びたい人も、実際に手を動かしながら学びたい人も、このセクションが役に立てれば幸いです。 -* If you prefer to **learn by doing**, start with our [practical tutorial](/tutorial/tutorial.html). -* If you prefer to **learn concepts step by step**, start with our [guide to main concepts](/docs/hello-world.html). +* **実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 +* **コンセプトから一つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 -Like any unfamiliar technology, React does have a learning curve. With practice and some patience, you *will* get the hang of it. +他の技術と新しく学ぶ時と同じように、 React には学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 -### First Examples +### 最初の数例 -The [React homepage](/) contains a few small React examples with a live editor. Even if you don't know anything about React yet, try changing their code and see how it affects the result. +この [React 公式ドキュメント](/)にはライブエディタにて記入できる小さい React の例が散らばっています。 まだ React のことを何も知らなくても、実際に触ってみてどの様に変化するかを見てみましょう。 -### React for Beginners +### React 初心者向けのガイド -If you feel that the React documentation goes at a faster pace than you're comfortable with, check out [this overview of React by Tania Rascia](https://www.taniarascia.com/getting-started-with-react/). It introduces the most important React concepts in a detailed, beginner-friendly way. Once you're done, give the documentation another try! +もし、React の公式ドキュメントのペースが早すぎると感じた場合は、[Tania Rascia氏によって書かれた React の概要](https://www.taniarascia.com/getting-started-with-react/)を読んでみましょう。 +ここでは React の一番大事なコンセプトについて詳細にえがかれており、初心者にもとても易しい作りとなっています。それが終わったら、もう一度公式ドキュメントを読んでみましょう！ -### React for Designers +### デザイナー向けのガイド -If you're coming from a design background, [these resources](http://reactfordesigners.com/) are a great place to get started. +デザイナーの背景がある方は、[これらの資料](http://reactfordesigners.com/)から始めることをおすすめします。 -### JavaScript Resources +### JavaScript 資料 -The React documentation assumes some familiarity with programming in the JavaScript language. You don't have to be an expert, but it's harder to learn both React and JavaScript at the same time. +React の公式ドキュメントはあなたがある程度 JavaScript について知っていることを想定しています。JavaScriptの達人である必要は全くありませんが、JavaScript と React を同時に取得するのは難しいでしょう。 -We recommend going through [this JavaScript overview](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript) to check your knowledge level. It will take you between 30 minutes and an hour but you will feel more confident learning React. +JavasScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。 +読むのに30分や1時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 >Tip > ->Whenever you get confused by something in JavaScript, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) and [javascript.info](http://javascript.info/) are great websites to check. There are also [community support forums](/community/support.html) where you can ask for help. +>もし JavaScript で何か詰まった時は、 [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) と [javascript.info](http://javascript.info/) を確認すると良いでしょう。また、[コミュニティの助け](/community/support.html)を活用するのもおすすめします。 -### Practical Tutorial +### 実践チュートリアル -If you prefer to **learn by doing,** check out our [practical tutorial](/tutorial/tutorial.html). In this tutorial, we build a tic-tac-toe game in React. You might be tempted to skip it because you're not building games -- but give it a chance. The techniques you'll learn in the tutorial are fundamental to building *any* React apps, and mastering it will give you a much deeper understanding. +**実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 +このチュートリアルでは React を使って ○×ゲームを作成します。ゲーム作成に興味が無い方は飛ばそうと思うかもしれませんが、試してみてください。 +ここで学ぶテクニックは*全ての* React アプリの基礎となることであり、習得することで React に関する深い理解を得るでしょう。 -### Step-by-Step Guide +### 一歩づつ進めるためのガイド -If you prefer to **learn concepts step by step,** our [guide to main concepts](/docs/hello-world.html) is the best place to start. Every next chapter in it builds on the knowledge introduced in the previous chapters so you won't miss anything as you go along. +**コンセプトから一つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +このガイドは章ごとに分かれていて、各章がそれまでに習ったことを上乗せする知識となっているため、余すことなく学ぶことができます。 -### Thinking in React +### React 的な考え方 -Many React users credit reading [Thinking in React](/docs/thinking-in-react.html) as the moment React finally "clicked" for them. It's probably the oldest React walkthrough but it's still just as relevant. +多くの React のユーザーは　[React 的な考え方](/docs/thinking-in-react.html)を読んだ時に React のことがわかってきたと高く評価しています。この世に存在する一番古い React に関する資料ですが、今でも現役で使えます。 -### Recommended Courses +### おすすめの資料 -Sometimes people find third-party books and video courses more helpful than the official documentation. We maintain [a list of commonly recommended resources](/community/courses.html), some of which are free. +時には第三者が執筆した技術書やオンラインコース等が公式ドキュメントよりもわかりやすいという人もいます。我々は[よく勧められている資料集](/community/courses.html)についてもまとめています。無料のものもあります。 -### Advanced Concepts +### 高度なコンセプト -Once you're comfortable with the [main concepts](#main-concepts) and played with React a little bit, you might be interested in more advanced topics. This section will introduce you to the powerful, but less commonly used React features like [context](/docs/context.html) and [refs](/docs/refs-and-the-dom.html). +React の[基本コンセプト](#main-concepts)について慣れてきて、実際手で動かしてみたら、今度はさらに高度な内容にも手を出したいと思うかもしれません。 +この資料では強力な、しかし普段使われることのない [context](/docs/context.html) や [ref](/docs/refs-and-the-dom.html) と言った React のさらなる機能について紹介します。 -### API Reference +### API リファレンス -This documentation section is useful when you want to learn more details about a particular React API. For example, [`React.Component` API reference](/docs/react-component.html) can provide you with details on how `setState()` works, and what different lifecycle methods are useful for. +この資料は特定の React API について学びたいときに役に立つでしょう。例えば、[`React.Component` API リファレンス](/docs/react-component.html)では `setState()` がどう機能しているかについてより詳細に記載されていたり、数々のライフサイクルメソッドがどの様に役に立つかについて書かれています。 -### Glossary and FAQ +### 用語集と FAQ -The [glossary](/docs/glossary.html) contains an overview of the most common terms you'll see in the React documentation. There is also a FAQ section dedicated to short questions and answers about common topics, including [making AJAX requests](/docs/faq-ajax.html), [component state](/docs/faq-state.html), and [file structure](/docs/faq-structure.html). +この[用語集](/docs/glossary.html)にはこのドキュメントにてよく使われる単語等が記載されています。 +[AJAX リクエストについて](/docs/faq-ajax.html)、[コンポーネントの state](/docs/faq-state.html)、[ファイル構成](/docs/faq-structure.html)等、よく頂く質問についても記載しています。 -## Staying Informed +## 最新の情報を追いたい人へ -The [React blog](/blog/) is the official source for the updates from the React team. Anything important, including release notes or deprecation notices, will be posted there first. +この [React ブログ](/blog/)は React チームからのアップデートについて記載する公式ブログです。 +機能が deprecated になる等、何か大事な発表がある時にはこのブログに真っ先に記載されます。 -You can also follow the [@reactjs account](https://twitter.com/reactjs) on Twitter, but you won't miss anything essential if you only read the blog. +他にも [@reactjs](https://twitter.com/reactjs) のツイッターアカウントをフォローすることもできますが、公式ブログを追っていれば何も見落とすことはないでしょう。 -Not every React release deserves its own blog post, but you can find a detailed changelog for every release [in the `CHANGELOG.md` file in the React repository](https://github.com/facebook/react/blob/master/CHANGELOG.md), as well as on the [Releases](https://github.com/facebook/react) page. +全ての React のリリースに記事があるわけではありませんが、リリース毎に詳細に書かれた changelog が [React リポジトリの`CHANGELOG.md`](https://github.com/facebook/react/blob/master/CHANGELOG.md)、および [Releases ページ](https://github.com/facebook/react)に記載されております。 -## Versioned Documentation +## バージョン管理されたドキュメント -This documentation always reflects the latest stable version of React. Since React 16, you can find older versions of the documentation [on a separate page](/versions). Note that documentation for past versions is snapshotted at the time of the release, and isn't being continuously updated. +このドキュメントは常に最新の stable版の React に準拠しています。React 16 からは古いバージョンのドキュメントも[別のページ](/versions)から閲覧できます。 +古いバージョンのドキュメントは各バージョンリリース時のスナップショットであり、更新をかけることはありません。 -## Something Missing? +## 他に聞きたいことは? -If something is missing in the documentation or if you found some part confusing, please [file an issue for the documentation repository](https://github.com/reactjs/reactjs.org/issues/new) with your suggestions for improvement, or tweet at the [@reactjs account](https://twitter.com/reactjs). We love hearing from you! +ドキュメントに記載されていないことがあったり、わかりにくい箇所があったりしたら、 困ったことや改善案等を[この公式ドキュメントのリポジトリ](https://github.com/reactjs/reactjs.org/issues/new)に issue として立てるか、もしくは公式の[@reactjs](https://twitter.com/reactjs)までご連絡ください。あなたのご意見をお待ちしております！ From 64c7c6eeec91d30aa58c19d6bf27c280500765ed Mon Sep 17 00:00:00 2001 From: jesse Date: Tue, 5 Feb 2019 00:00:49 +0900 Subject: [PATCH 3/7] docs: run textlint on getting-started --- content/docs/getting-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index f43876b87..d56ee0ceb 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -61,7 +61,7 @@ React を学びたい人には様々な背景があり、それぞれいろん 理論から学びたい人も、実際に手を動かしながら学びたい人も、このセクションが役に立てれば幸いです。 * **実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 -* **コンセプトから一つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +* **コンセプトから1つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 他の技術と新しく学ぶ時と同じように、 React には学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 @@ -97,7 +97,7 @@ JavasScript について自分がどれだけ知っているかを知るため ### 一歩づつ進めるためのガイド -**コンセプトから一つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +**コンセプトから1つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 このガイドは章ごとに分かれていて、各章がそれまでに習ったことを上乗せする知識となっているため、余すことなく学ぶことができます。 ### React 的な考え方 @@ -136,6 +136,6 @@ React の[基本コンセプト](#main-concepts)について慣れてきて、 このドキュメントは常に最新の stable版の React に準拠しています。React 16 からは古いバージョンのドキュメントも[別のページ](/versions)から閲覧できます。 古いバージョンのドキュメントは各バージョンリリース時のスナップショットであり、更新をかけることはありません。 -## 他に聞きたいことは? +## 他に聞きたいことは？ ドキュメントに記載されていないことがあったり、わかりにくい箇所があったりしたら、 困ったことや改善案等を[この公式ドキュメントのリポジトリ](https://github.com/reactjs/reactjs.org/issues/new)に issue として立てるか、もしくは公式の[@reactjs](https://twitter.com/reactjs)までご連絡ください。あなたのご意見をお待ちしております！ From eeb0eb23c56d51dea8ca3937a2388855be73fee0 Mon Sep 17 00:00:00 2001 From: jesse Date: Tue, 5 Feb 2019 00:03:48 +0900 Subject: [PATCH 4/7] lint: apply text lint with the latest master branch --- content/docs/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index d56ee0ceb..1c729d342 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -61,7 +61,7 @@ React を学びたい人には様々な背景があり、それぞれいろん 理論から学びたい人も、実際に手を動かしながら学びたい人も、このセクションが役に立てれば幸いです。 * **実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 -* **コンセプトから1つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +* **コンセプトから1つ1つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 他の技術と新しく学ぶ時と同じように、 React には学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 @@ -97,7 +97,7 @@ JavasScript について自分がどれだけ知っているかを知るため ### 一歩づつ進めるためのガイド -**コンセプトから1つ一つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +**コンセプトから1つ1つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 このガイドは章ごとに分かれていて、各章がそれまでに習ったことを上乗せする知識となっているため、余すことなく学ぶことができます。 ### React 的な考え方 From 10d406aa95e14a5d91ce5beab4039eefa8e95f07 Mon Sep 17 00:00:00 2001 From: jesse Date: Wed, 6 Feb 2019 19:23:01 +0900 Subject: [PATCH 5/7] docs: fix reviewed parts --- content/docs/getting-started.md | 65 +++++++++++++-------------------- 1 file changed, 26 insertions(+), 39 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 1c729d342..5c58a5db6 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -29,50 +29,45 @@ redirect_from: - [React を学ぶ](#learn-react) - [最新の情報を追いたい人へ](#staying-informed) - [バージョン管理されたドキュメント](#versioned-documentation) -- [足りないものがある?](#something-missing) +- [足りないものがある？](#something-missing) ## React を試す React は初めから既存のプロジェクトに徐々に追加していけるようなデザインとなっています。 **あなたは React をどれだけ使っても問題ありません。** 触りだけやってみるもよし、シンプルな HTML のページにインタラクティブな機能を追加するのに使うもよし、React をフル活用した複雑なアプリを作成するもよし。どのような目的にしても、このページにあるリンクが役に立つでしょう。 -### Web 上で試す +### Web 上で試せるオンラインエディタ -React を試してみたかったら、Web 上のコードエディタでも試すことができます。 -[CodePen](codepen://hello-world) や [CodeSandbox](https://codesandbox.io/s/new) で Hello World のテンプレートを使って試してみましょう。 +React をちょっと試してみたい場合、Web 上のコードエディタが使えます。[CodePen](codepen://hello-world) や [CodeSandbox](https://codesandbox.io/s/new) で Hello World のテンプレートを使って試してみましょう。 -自前のテキストエディタを使いたい場合は、[この HTML ファイル](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)をダウンロードして、編集して、ブラウザからローカルで開くことができます。 -ランタイムでのコード変換が行われる為、簡単なデモに留めておくことをおすすめします。 +自前のテキストエディタを使いたい場合は、[この HTML ファイル](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)をダウンロード・編集して、ブラウザを使ってからローカルファイルシステムから開くことができます。ランタイムでの遅いコード変換が行われる為、簡単なデモに留めておくことをおすすめします。 ### React を Web サイトに追加する -[React は HTML ページにすぐに追加することができます。](/docs/add-react-to-a-website.html) 追加したら、徐々に全体に反映させていくか、数量のダイナミックなウィジェットに留めるかはあなたの自由です。 +[React は HTML ページにすぐに追加することができます](/docs/add-react-to-a-website.html)。そのあと徐々に全体に反映させていくか、少数のダイナミックなウィジェットに留めるかはあなたの自由です。 ### 新規 React アプリの作成 新しく React のプロジェクトを始めたい場合でも、まずは[シンプルな HTML ページに script タグを追加](/docs/add-react-to-a-website.html)するのがおすすめです。数分でセットアップできます！ -アプリが成長するにつれて、より統合されたセットアップを行うことを考慮していきましょう。 -大きいアプリの為には我々が勧める [様々なJavaScript を用いたツールチェイン](/docs/create-a-new-react-app.html)が存在します。 -それぞれ少ない設定、もしくは設定要らずでリッチな React のエコシステムを活用していくことができます。 +アプリが成長するにつれて、より統合されたセットアップを行うことを考慮していきましょう。大きいアプリの場 +場合におすすめの[様々な JavaScript を用いたツールチェイン](/docs/create-a-new-react-app.html)が存在します。それぞれわずかな設定、もしくは設定要らずでリッチな React のエコシステムをフル活用できます。 ## React を学ぶ -React を学びたい人には様々な背景があり、それぞれいろんな学び方のスタイルがあるでしょう。 -理論から学びたい人も、実際に手を動かしながら学びたい人も、このセクションが役に立てれば幸いです。 +React を学びたい人には様々な背景があり、それぞれいろんな学び方のスタイルがあるでしょう。理論から学びたい人も、実際に手を動かしながら学びたい人も、このセクションが役に立てれば幸いです。 * **実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 -* **コンセプトから1つ1つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 +* **コンセプトからひとつひとつ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 -他の技術と新しく学ぶ時と同じように、 React には学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 +他の新しい技術を新しく学ぶ時と同様、 React にも学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 -### 最初の数例 +### 最初の例 -この [React 公式ドキュメント](/)にはライブエディタにて記入できる小さい React の例が散らばっています。 まだ React のことを何も知らなくても、実際に触ってみてどの様に変化するかを見てみましょう。 +[React のホームページ](/)にはライブエディタにて記入できる小さな React のサンプルがいくつか載っています。まだ React のことを何も知らなくても、実際に触ってみてどのように変化するか見てみましょう。 ### React 初心者向けのガイド -もし、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 の重要なコンセプトについて詳細に説明されており、初心者にもとても易しい作りとなっています。それが終わったら、もう一度公式ドキュメントを読んでみましょう！ ### デザイナー向けのガイド @@ -82,27 +77,23 @@ React を学びたい人には様々な背景があり、それぞれいろん React の公式ドキュメントはあなたがある程度 JavaScript について知っていることを想定しています。JavaScriptの達人である必要は全くありませんが、JavaScript と React を同時に取得するのは難しいでしょう。 -JavasScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。 -読むのに30分や1時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 +JavasScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。読むのに 30 分や 1 時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 ->Tip +> ヒント > ->もし 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](http://javascript.info/) を確認すると良いでしょう。また、[コミュニティ運営の掲示板](/community/support.html)を活用するのもおすすめします。 ### 実践チュートリアル -**実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 -このチュートリアルでは React を使って ○×ゲームを作成します。ゲーム作成に興味が無い方は飛ばそうと思うかもしれませんが、試してみてください。 -ここで学ぶテクニックは*全ての* React アプリの基礎となることであり、習得することで React に関する深い理解を得るでしょう。 +**実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。このチュートリアルでは React を使って三目並べゲームを作成します。ゲーム作成に興味が無い方は飛ばそうと思うかもしれませんが、試してみてください。ここで学ぶテクニックは*全ての* React アプリの基礎となることであり、習得することで React に関する深い理解を得るでしょう。 ### 一歩づつ進めるためのガイド -**コンセプトから1つ1つ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 -このガイドは章ごとに分かれていて、各章がそれまでに習ったことを上乗せする知識となっているため、余すことなく学ぶことができます。 +**コンセプトからひとつひとつ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。このガイドは章ごとに分かれていて、各章がそれまでに習ったことを上乗せする知識となっているため、余すことなく学ぶことができます。 ### React 的な考え方 -多くの React のユーザーは　[React 的な考え方](/docs/thinking-in-react.html)を読んだ時に React のことがわかってきたと高く評価しています。この世に存在する一番古い React に関する資料ですが、今でも現役で使えます。 +多くの React のユーザーは　[React の流儀](/docs/thinking-in-react.html)を読んだ時に React のことがわかってきたと高く評価しています。この世に存在する一番古い React に関する資料ですが、今でも現役で使えます。 ### おすすめの資料 @@ -110,31 +101,27 @@ JavasScript について自分がどれだけ知っているかを知るため ### 高度なコンセプト -React の[基本コンセプト](#main-concepts)について慣れてきて、実際手で動かしてみたら、今度はさらに高度な内容にも手を出したいと思うかもしれません。 -この資料では強力な、しかし普段使われることのない [context](/docs/context.html) や [ref](/docs/refs-and-the-dom.html) と言った React のさらなる機能について紹介します。 +React の[基本コンセプト](#main-concepts)について慣れてきて、実際手で動かしてみたら、今度はさらに高度な内容にも手を出したいと思うかもしれません。この資料では強力な、しかし普段使われることのない [コンテキスト](/docs/context.html) や [ref](/docs/refs-and-the-dom.html) といった React のさらなる機能について紹介します。 ### API リファレンス -この資料は特定の React API について学びたいときに役に立つでしょう。例えば、[`React.Component` API リファレンス](/docs/react-component.html)では `setState()` がどう機能しているかについてより詳細に記載されていたり、数々のライフサイクルメソッドがどの様に役に立つかについて書かれています。 +この資料は特定の React API の詳細について学びたいときに役に立つでしょう。例えば、[`React.Component` API リファレンス](/docs/react-component.html)では `setState()` がどう機能しているかについてより詳細に記載されていたり、種々のライフサイクルメソッドがどのように役に立つかについて書かれています。 ### 用語集と FAQ -この[用語集](/docs/glossary.html)にはこのドキュメントにてよく使われる単語等が記載されています。 -[AJAX リクエストについて](/docs/faq-ajax.html)、[コンポーネントの state](/docs/faq-state.html)、[ファイル構成](/docs/faq-structure.html)等、よく頂く質問についても記載しています。 +この[用語集](/docs/glossary.html)にはこのドキュメントにてよく使われる単語等が記載されています。 [AJAX リクエストについて](/docs/faq-ajax.html)、[コンポーネントの state](/docs/faq-state.html)、[ファイル構成](/docs/faq-structure.html)等、よく頂く質問についても記載しています。 ## 最新の情報を追いたい人へ -この [React ブログ](/blog/)は React チームからのアップデートについて記載する公式ブログです。 -機能が deprecated になる等、何か大事な発表がある時にはこのブログに真っ先に記載されます。 +[React ブログ](/blog/)は React チームからのアップデートが記載されている公式ブログです。リリースノートや機能の非推奨化の告知など、何か大事な発表がある時にはこのブログに真っ先に記載されます。 -他にも [@reactjs](https://twitter.com/reactjs) のツイッターアカウントをフォローすることもできますが、公式ブログを追っていれば何も見落とすことはないでしょう。 +他にも [@reactjs](https://twitter.com/reactjs) のツイッターアカウントをフォローすることもできますが、公式ブログを追っていれば大事なことを見落とすことはないでしょう。 -全ての React のリリースに記事があるわけではありませんが、リリース毎に詳細に書かれた changelog が [React リポジトリの`CHANGELOG.md`](https://github.com/facebook/react/blob/master/CHANGELOG.md)、および [Releases ページ](https://github.com/facebook/react)に記載されております。 +全ての React のリリースにブログ記事があるわけではありませんが、リリースごとに詳細に書かれた changelog が [React リポジトリの `CHANGELOG.md`](https://github.com/facebook/react/blob/master/CHANGELOG.md)、および [Releases ページ](https://github.com/facebook/react)に記載されています。 ## バージョン管理されたドキュメント -このドキュメントは常に最新の stable版の React に準拠しています。React 16 からは古いバージョンのドキュメントも[別のページ](/versions)から閲覧できます。 -古いバージョンのドキュメントは各バージョンリリース時のスナップショットであり、更新をかけることはありません。 +このドキュメントは常に最新の stable 版の React に準拠しています。React 16 からは古いバージョンのドキュメントも[別のページ](/versions)から閲覧できます。古いバージョンのドキュメントは各バージョンリリース時のスナップショットであり、更新をかけることはありません。 ## 他に聞きたいことは？ From 5667fcb90c7cb3cd3e94c16961f16d585bcebfb7 Mon Sep 17 00:00:00 2001 From: jesse Date: Fri, 8 Feb 2019 10:08:42 +0900 Subject: [PATCH 6/7] doc: fix reviewed section --- content/docs/getting-started.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 5c58a5db6..aed7a0478 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -20,8 +20,7 @@ redirect_from: このページは React のドキュメント、および関連する資料の概要となります。 -**React** はユーザーインターフェースを作成する為の JavaScript のライブラリです。 -[ここのホームページ](/)、または[このチュートリアル](/tutorial/tutorial.html)から React がどういうものかを学びましょう。 +**React** はユーザーインターフェースを作成する為の JavaScript のライブラリです。[ここのホームページ](/)、または[このチュートリアル](/tutorial/tutorial.html)から React がどういうものかを学びましょう。 --- @@ -49,8 +48,7 @@ React をちょっと試してみたい場合、Web 上のコードエディタ 新しく React のプロジェクトを始めたい場合でも、まずは[シンプルな HTML ページに script タグを追加](/docs/add-react-to-a-website.html)するのがおすすめです。数分でセットアップできます！ -アプリが成長するにつれて、より統合されたセットアップを行うことを考慮していきましょう。大きいアプリの場 -場合におすすめの[様々な JavaScript を用いたツールチェイン](/docs/create-a-new-react-app.html)が存在します。それぞれわずかな設定、もしくは設定要らずでリッチな React のエコシステムをフル活用できます。 +アプリが成長するにつれて、より統合されたセットアップを行うことを考慮していきましょう。大きいアプリの場合におすすめの[様々な JavaScript を用いたツールチェイン](/docs/create-a-new-react-app.html)が存在します。それぞれわずかな設定、もしくは設定要らずでリッチな React のエコシステムをフル活用できます。 ## React を学ぶ @@ -71,13 +69,13 @@ React を学びたい人には様々な背景があり、それぞれいろん ### デザイナー向けのガイド -デザイナーの背景がある方は、[これらの資料](http://reactfordesigners.com/)から始めることをおすすめします。 +もしあなたがデザイナーのバックグラウンドを持っているなら、[これらの資料](http://reactfordesigners.com/)から始めることをおすすめします。 ### JavaScript 資料 React の公式ドキュメントはあなたがある程度 JavaScript について知っていることを想定しています。JavaScriptの達人である必要は全くありませんが、JavaScript と React を同時に取得するのは難しいでしょう。 -JavasScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。読むのに 30 分や 1 時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 +JavaScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。読むのに 30 分から 1 時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 > ヒント > @@ -101,7 +99,7 @@ JavasScript について自分がどれだけ知っているかを知るため ### 高度なコンセプト -React の[基本コンセプト](#main-concepts)について慣れてきて、実際手で動かしてみたら、今度はさらに高度な内容にも手を出したいと思うかもしれません。この資料では強力な、しかし普段使われることのない [コンテキスト](/docs/context.html) や [ref](/docs/refs-and-the-dom.html) といった React のさらなる機能について紹介します。 +React の[基本コンセプト](#main-concepts)について慣れてきて、実際に手で動かしてみたら、今度はさらに高度な内容にも手を出したいと思うかもしれません。この資料では強力な、しかし普段使われることのない [コンテキスト](/docs/context.html) や [ref](/docs/refs-and-the-dom.html) といった React のさらなる機能について紹介します。 ### API リファレンス @@ -109,7 +107,7 @@ React の[基本コンセプト](#main-concepts)について慣れてきて、 ### 用語集と FAQ -この[用語集](/docs/glossary.html)にはこのドキュメントにてよく使われる単語等が記載されています。 [AJAX リクエストについて](/docs/faq-ajax.html)、[コンポーネントの state](/docs/faq-state.html)、[ファイル構成](/docs/faq-structure.html)等、よく頂く質問についても記載しています。 +この[用語集](/docs/glossary.html)にはこのドキュメントにてよく使われる単語等が記載されています。 FAQもあり、[AJAX リクエストについて](/docs/faq-ajax.html)、[コンポーネントの state](/docs/faq-state.html)、[ファイル構成](/docs/faq-structure.html)などのよくある質問とそれらに対する回答が記載されています。 ## 最新の情報を追いたい人へ From f53806921ee8c9a718d63c83092ce7eb1f04a589 Mon Sep 17 00:00:00 2001 From: Jesse Katsumata Date: Sat, 9 Feb 2019 21:44:43 +0900 Subject: [PATCH 7/7] docs: fix spacing --- content/docs/getting-started.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 14816edc8..b4bfb763d 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -57,7 +57,7 @@ React を学びたい人には様々な背景があり、それぞれいろん * **実際に手を動かしながら学びたい人**は[チュートリアル](/tutorial/tutorial.html)からはじめましょう。 * **コンセプトからひとつひとつ学んでいきたい人**は[こちらのガイド](/docs/hello-world.html)からはじめていきましょう。 -他の新しい技術を新しく学ぶ時と同様、 React にも学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 +他の新しい技術を新しく学ぶ時と同様、React にも学習コストがあります。しかし、辛抱強く、地道にコツコツやっていくことで、*絶対に*できるようになります。 ### 最初の例 {#first-examples} @@ -73,7 +73,7 @@ React を学びたい人には様々な背景があり、それぞれいろん ### JavaScript 資料 {#javascript-resources} -React の公式ドキュメントはあなたがある程度 JavaScript について知っていることを想定しています。JavaScriptの達人である必要は全くありませんが、JavaScript と React を同時に取得するのは難しいでしょう。 +React の公式ドキュメントはあなたがある程度 JavaScript について知っていることを想定しています。JavaScript の達人である必要は全くありませんが、JavaScript と React を同時に取得するのは難しいでしょう。 JavaScript について自分がどれだけ知っているかを知るために、[この JavaScript の概要](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)を読んでおくことをおすすめします。読むのに 30 分から 1 時間程かかってしまいますが、React を学ぶための自信へと繋がってくるでしょう。 @@ -91,7 +91,7 @@ JavaScript について自分がどれだけ知っているかを知るために ### React 的な考え方 {#thinking-in-react} -多くの React のユーザーは　[React の流儀](/docs/thinking-in-react.html)を読んだ時に React のことがわかってきたと高く評価しています。この世に存在する一番古い React に関する資料ですが、今でも現役で使えます。 +多くの React のユーザーは [React の流儀](/docs/thinking-in-react.html)を読んだ時に React についてピンときたと高く評価しています。この世に存在する一番古い React に関する資料ですが、今でも現役で使えます。 ### おすすめの資料 {#recommended-courses} @@ -123,4 +123,4 @@ React の[基本コンセプト](#main-concepts)について慣れてきて、 ## 他に聞きたいことは？ {#something-missing} -ドキュメントに記載されていないことがあったり、わかりにくい箇所があったりしたら、 困ったことや改善案等を[この公式ドキュメントのリポジトリ](https://github.com/reactjs/reactjs.org/issues/new)に issue として立てるか、もしくは公式の[@reactjs](https://twitter.com/reactjs)までご連絡ください。あなたのご意見をお待ちしております！ +ドキュメントに記載されていないことがあったり、わかりにくい箇所があったりしたら、 困ったことや改善案等を[この公式ドキュメントのリポジトリ](https://github.com/reactjs/reactjs.org/issues/new)に issue として立てるか、もしくは公式の [@reactjs](https://twitter.com/reactjs) までご連絡ください。あなたのご意見をお待ちしております！