From 35bd534d6b8a6908543ab32177eba3d6dda4cfc5 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 03:46:35 +0500 Subject: [PATCH 01/11] Translate "Getting Started" (getting-started.md) --- content/docs/getting-started.md | 112 ++++++++++++++++---------------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 5625bb3cd..d616e5cfc 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -1,6 +1,6 @@ --- id: getting-started -title: Getting Started +title: С чего начать? permalink: docs/getting-started.html next: add-react-to-a-website.html redirect_from: @@ -18,109 +18,109 @@ 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, предназначенная для разработки пользовательского интерфейса. Узнать все подробности о React вы можете на нашей [домашней странице](/) или в [практическом руководстве](/tutorial/tutorial.html). --- -- [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) +- [Документация на прошлые версии React](#versioned-documentation) +- [Обратная связь](#something-missing) -## Try React {#try-react} +## Пробуйте React {#try-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, который необходим вам в данный момент.** Возможно, в скором времени вам захочется получше распробовать React, оживить свои простенькие HTML странички или даже приступить к разработке сложного web—приложения. Ссылки в данном разделе помогут вам начать первое знакомство с React. -### Online Playgrounds {#online-playgrounds} +### Тестирование React в online песочницах {#online-playgrounds} -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, то вы можете использовать online песочницы для тестирования его возможностей. Например, можно попробовать шаблон Hello World в [CodePen](codepen://hello-world) или [CodeSandbox](https://codesandbox.io/s/new). -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. +В том случае, если вы предпочитаете использовать свой собственный редактор или IDE, то можно [скачать тестовый HTML файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавить в него пробный код и запустить на своем компьютере. В тестовом файле используется библиотека babel для преобразования кода React в обычный код на JavaScript. Это происходит налету непосредственно в вашем браузере. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. -### Add React to a Website {#add-react-to-a-website} +### Добавление React на сайт {#add-react-to-a-website} -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 на свой сайт буквально за одну минуту](/docs/add-react-to-a-website.html). После этого можно постепенно расширять использование React в своём проекте или ограничиться добавлением на страницу нескольких динамических элементов. -### Create a New React App {#create-a-new-react-app} +### Создание нового web—приложения {#create-a-new-react-app} -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 {#learn-react} +## Изучайте React {#learn-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). +* Если вам больше нравится **познавать предмет шаг за шагом**, то начните с [подробного описания основных принципов React](/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 не имеет строго определенного направления изучения или последовательного учебного курса, однако, набравшись терпения и приложив достаточное усердие, вы *обязательно* освоите React. Терпение и труд все перетрут! -### First Examples {#first-examples} +### Простые примеры {#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-for-beginners} +### React для новичков {#react-for-beginners} -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)](https://www.taniarascia.com/getting-started-with-react/). В нем Таня на простом языке подробно рассказала о наиболее важных концепциях React. Всё, что вам теперь нужно, это дать документации еще один шанс! -### React for Designers {#react-for-designers} +### 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/) будет отличным местом, с которого вы сможете начать изучение React. -### JavaScript Resources {#javascript-resources} +### Ресурсы по JavaScript {#javascript-resources} -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. Вы не обязаны быть экспертом, но учтите, что для одновременного изучения и React, и JavaScript потребуется значительно больше времени. -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. +Чтобы освежить ваши знания, мы рекомендуем просмотреть [обзор языка JavaScript на сайте mozilla.org](https://developer.mozilla.org/ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript). Для этого потребуется от 30 минут до часа. Надеемся, что теперь вы будете чувствовать себя более комфортно при изучении 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/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации чтобы пификсить их. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). -### Practical Tutorial {#practical-tutorial} +### Практическое руководство {#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. Она даст вам более глубокое понимание этой библиотеки. -### Step-by-Step Guide {#step-by-step-guide} +### Подробное описание 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. +Если вам больше нравится **познавать предмет шаг за шагом**, то лучше начать с [подробного описания основных принципов React](/docs/hello-world.html). Каждая последующая глава описания базируется на знаниях предыдущей, поэтому вы ничего не упстите в процессе изучения материала. -### Thinking in React {#thinking-in-react} +### Мыслить в стиле React {#thinking-in-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 {#recommended-courses} +### Рекомендуемые курсы {#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 {#advanced-concepts} +### Углублённое изучение React {#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) и немного поиграетесь с ним, вам захочется углубиться в более продвинутые разделы документации. В этих главах описан очень мощный, но не так часто используемый функционал React. Например, [context](/docs/context.html) и [refs](/docs/refs-and-the-dom.html). -### API Reference {#api-reference} +### API {#api-reference} -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 {#glossary-and-faq} +### Глоссарий и ЧаВо {#glossary-and-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), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). -## Staying Informed {#staying-informed} +## Будьте в курсе {#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/) это источник официальной информации от нашей команды об обновлениях. Все самые важные новости, включая описание изменений в релизах или списки нерекомендуемых к использованию функций, будут публиковаться здесь в первую очередь. -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) в Twitter, но всё—таки, если вы не хотите пропустить что—нибудь по—настоящему важное, читайте блог. -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.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). -## Versioned Documentation {#versioned-documentation} +## Документация на прошлые версии 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. +Документация на сайте всегда соответствует последнему стабильному релизу. Начиная с 16 версии React, мы публикуем старые версии документации [на отдельной странице](/versions). Учтите, что копии документации на прошлые версии создаются в момент выхода релиза и более не обновляются. -## Something Missing? {#something-missing} +## Обратная связь {#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) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! From ec29777b500ec89eeace6220821fbcf166f3c361 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 04:54:27 +0500 Subject: [PATCH 02/11] Update getting-started.md --- content/docs/getting-started.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index d616e5cfc..8d3109316 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -1,6 +1,6 @@ --- id: getting-started -title: С чего начать? +title: Начало работы permalink: docs/getting-started.html next: add-react-to-a-website.html redirect_from: @@ -20,7 +20,7 @@ redirect_from: На этой странице мы сделаем небольшой обзор документации и других ресурсов, которые могут быть полезны при первом использовании React. -**React** это библиотека на языке JavaScript, предназначенная для разработки пользовательского интерфейса. Узнать все подробности о React вы можете на нашей [домашней странице](/) или в [практическом руководстве](/tutorial/tutorial.html). +**React** - JavaScript-библиотека, предназначенная для разработки пользовательского интерфейса. Узнать всё о React вы можете на [домашней странице](/) или в [практическом руководстве](/tutorial/tutorial.html). --- @@ -32,7 +32,7 @@ redirect_from: ## Пробуйте React {#try-react} -React изначально был спроектирован так, чтобы его можно было внедрять постепенно. Другими словами, **вы можете начать с малого и использовать только тот функционал React, который необходим вам в данный момент.** Возможно, в скором времени вам захочется получше распробовать React, оживить свои простенькие HTML странички или даже приступить к разработке сложного web—приложения. Ссылки в данном разделе помогут вам начать первое знакомство с React. +React изначально был спроектирован так, чтобы его можно было внедрять постепенно. Другими словами, **вы можете начать с малого и использовать только тот функционал React, который необходим вам в данный момент.** Возможно, в скором времени вам захочется получше распробовать React, оживить свои простенькие HTML странички или даже приступить к разработке сложного web-приложения. Ссылки в данном разделе помогут вам начать первое знакомство с React. ### Тестирование React в online песочницах {#online-playgrounds} @@ -44,7 +44,7 @@ React изначально был спроектирован так, чтобы Вы можете [добавить React на свой сайт буквально за одну минуту](/docs/add-react-to-a-website.html). После этого можно постепенно расширять использование React в своём проекте или ограничиться добавлением на страницу нескольких динамических элементов. -### Создание нового web—приложения {#create-a-new-react-app} +### Создание нового React-приложения {#create-a-new-react-app} Когда вы начинаете проект на React, [то простая HTML страница с тегами script](/docs/add-react-to-a-website.html) может быть лучшим вариантом. Ведь для её создания вам потребуется меньше минуты. @@ -52,7 +52,7 @@ React изначально был спроектирован так, чтобы ## Изучайте React {#learn-react} -Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения при изучении новых технологий: кто—то погружается в теорию, а кто—то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. +Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения при изучении новых технологий: кто-то погружается в теорию, а кто-то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. * Если вы предпочитаете **изучать технологии на практике**, начните с [практического руководства](/tutorial/tutorial.html). * Если вам больше нравится **познавать предмет шаг за шагом**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). @@ -61,7 +61,7 @@ React изначально был спроектирован так, чтобы ### Простые примеры {#first-examples} -На [домашней странице React](/) есть несколько маленьких примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока абсолютно ничего не знаете о React, попробуйте что—нибудь поменять в коде этих примеров и посмотрите на результат. +На [домашней странице React](/) есть несколько маленьких примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока абсолютно ничего не знаете о React, попробуйте что-нибудь поменять в коде этих примеров и посмотрите на результат. ### React для новичков {#react-for-beginners} @@ -79,11 +79,11 @@ React изначально был спроектирован так, чтобы >Совет > ->Если всё—таки у вас остались пробелы в знаниях о JavaScript, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации чтобы пификсить их. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). +>Если всё-таки у вас остались пробелы в знаниях о JavaScript, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации чтобы пификсить их. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). ### Практическое руководство {#practical-tutorial} -Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь нашим [практическим руководством](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики—нолики. Даже если вы не планируете программировать игры, всё равно пройдите это руководство. Технология, которую вы освоите, является фундаментом для разработки *любых* приложений на React. Она даст вам более глубокое понимание этой библиотеки. +Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь нашим [практическим руководством](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно пройдите это руководство. Технология, которую вы освоите, является фундаментом для разработки *любых* приложений на React. Она даст вам более глубокое понимание этой библиотеки. ### Подробное описание React {#step-by-step-guide} @@ -91,7 +91,7 @@ React изначально был спроектирован так, чтобы ### Мыслить в стиле React {#thinking-in-react} -Многие пользователи React отмечают, что прочтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "торкнул" их по—настоящему. Возможно это самое древнее руководство по React, но оно всё ещё в силе. +Многие пользователи React отмечают, что прочтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "торкнул" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё в силе. ### Рекомендуемые курсы {#recommended-courses} @@ -113,7 +113,7 @@ React изначально был спроектирован так, чтобы [Блог о React](/blog/) это источник официальной информации от нашей команды об обновлениях. Все самые важные новости, включая описание изменений в релизах или списки нерекомендуемых к использованию функций, будут публиковаться здесь в первую очередь. -Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter, но всё—таки, если вы не хотите пропустить что—нибудь по—настоящему важное, читайте блог. +Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter, но всё-таки, если вы не хотите пропустить что-нибудь по-настоящему важное, читайте блог. В блоге мы пишем не о всех релизах React, но всегда есть возможность посмотреть список изменений для всех релизов [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). @@ -123,4 +123,4 @@ React изначально был спроектирован так, чтобы ## Обратная связь {#something-missing} -Если вы обнаружите в документации какие—нибудь неточности, ошибки или любые другие непонятки, пожаулйста, [создайте сообщение об ошибке в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! +Если вы обнаружите в документации какие-нибудь неточности, ошибки или любые другие непонятки, пожаулйста, [создайте сообщение об ошибке в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! From 0d5b11436eb174d5793ae4e790060da8a8048051 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 05:23:17 +0500 Subject: [PATCH 03/11] Update getting-started.md --- content/docs/getting-started.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 8d3109316..4c003dd48 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -20,7 +20,7 @@ redirect_from: На этой странице мы сделаем небольшой обзор документации и других ресурсов, которые могут быть полезны при первом использовании React. -**React** - JavaScript-библиотека, предназначенная для разработки пользовательского интерфейса. Узнать всё о React вы можете на [домашней странице](/) или в [практическом руководстве](/tutorial/tutorial.html). +**React** - JavaScript-библиотека, предназначенная для разработки пользовательского интерфейса. Узнать всё о React вы можете на [главной странице](/) или во [введении](/tutorial/tutorial.html). --- @@ -54,14 +54,14 @@ React изначально был спроектирован так, чтобы Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения при изучении новых технологий: кто-то погружается в теорию, а кто-то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. -* Если вы предпочитаете **изучать технологии на практике**, начните с [практического руководства](/tutorial/tutorial.html). +* Если вы предпочитаете **изучать технологии на практике**, начните с [введения](/tutorial/tutorial.html). * Если вам больше нравится **познавать предмет шаг за шагом**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). Также как любые другие новые технологии React не имеет строго определенного направления изучения или последовательного учебного курса, однако, набравшись терпения и приложив достаточное усердие, вы *обязательно* освоите React. Терпение и труд все перетрут! ### Простые примеры {#first-examples} -На [домашней странице React](/) есть несколько маленьких примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока абсолютно ничего не знаете о React, попробуйте что-нибудь поменять в коде этих примеров и посмотрите на результат. +На [главной странице](/) есть несколько маленьких примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока абсолютно ничего не знаете о React, попробуйте что-нибудь поменять в коде этих примеров и посмотрите на результат. ### React для новичков {#react-for-beginners} @@ -81,9 +81,9 @@ React изначально был спроектирован так, чтобы > >Если всё-таки у вас остались пробелы в знаниях о JavaScript, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации чтобы пификсить их. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). -### Практическое руководство {#practical-tutorial} +### Введение {#practical-tutorial} -Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь нашим [практическим руководством](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно пройдите это руководство. Технология, которую вы освоите, является фундаментом для разработки *любых* приложений на React. Она даст вам более глубокое понимание этой библиотеки. +Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь [введением](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно пройдите это руководство. Технология, которую вы освоите, является фундаментом для разработки *любых* приложений на React. Она даст вам более глубокое понимание этой библиотеки. ### Подробное описание React {#step-by-step-guide} From fe5b65c1eea396e7e4d6ac0e736e10ada922123e Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 17:49:13 +0500 Subject: [PATCH 04/11] Update getting-started.md --- content/docs/getting-started.md | 66 ++++++++++++++++----------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 4c003dd48..3392bed6b 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -18,41 +18,41 @@ redirect_from: - "docs/environments.html" --- -На этой странице мы сделаем небольшой обзор документации и других ресурсов, которые могут быть полезны при первом использовании React. +На этой странице мы сделаем небольшой обзор документации и других ресурсов, которые могут пригодиться при первом использовании React. -**React** - JavaScript-библиотека, предназначенная для разработки пользовательского интерфейса. Узнать всё о React вы можете на [главной странице](/) или во [введении](/tutorial/tutorial.html). +**React** — это JavaScript-библиотека для разработки пользовательского интерфейса. Чтобы составить первое впечатление о React зайдите на [главную страницу](/) или во [введение](/tutorial/tutorial.html). --- -- [Пробуйте React](#try-react) -- [Изучайте React](#learn-react) -- [Будьте в курсе](#staying-informed) -- [Документация на прошлые версии React](#versioned-documentation) +- [Пробуем React](#try-react) +- [Изучаем React](#learn-react) +- [Информация о релизах](#staying-informed) +- [Документация на старые версии React](#versioned-documentation) - [Обратная связь](#something-missing) -## Пробуйте React {#try-react} +## Пробуем React {#try-react} -React изначально был спроектирован так, чтобы его можно было внедрять постепенно. Другими словами, **вы можете начать с малого и использовать только тот функционал React, который необходим вам в данный момент.** Возможно, в скором времени вам захочется получше распробовать React, оживить свои простенькие HTML странички или даже приступить к разработке сложного web-приложения. Ссылки в данном разделе помогут вам начать первое знакомство с React. +React изначально был спроектирован так, чтобы его можно было внедрять постепенно. Другими словами, **вы можете начать с малого и использовать только тот функционал React, который необходим вам в данный момент.** Информация в этом разделе будет полезна в любой ситуации: при первом знакомстве с React, при создании простой динамической HTML-страницы и даже при проектировании сложного React-приложения. -### Тестирование React в online песочницах {#online-playgrounds} +### Онлайн-песочницы {#online-playgrounds} -Если вам захочется немного поиграть с React, то вы можете использовать online песочницы для тестирования его возможностей. Например, можно попробовать шаблон Hello World в [CodePen](codepen://hello-world) или [CodeSandbox](https://codesandbox.io/s/new). +Если вы просто хотите немного поиграть с React, попробуйте онлайн-песочницу. Например, вот простейший шаблон на [CodePen](codepen://hello-world) или [CodeSandbox](https://codesandbox.io/s/new). -В том случае, если вы предпочитаете использовать свой собственный редактор или IDE, то можно [скачать тестовый HTML файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавить в него пробный код и запустить на своем компьютере. В тестовом файле используется библиотека babel для преобразования кода React в обычный код на JavaScript. Это происходит налету непосредственно в вашем браузере. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. +Если вы предпочитаете работать в своем редакторе, [скачайте тестовый HTML-файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавьте в него код и запустите на своем компьютере. В тестовом файле используется библиотека babel для преобразования кода React в обычный код на JavaScript. Это происходит налету непосредственно в вашем браузере. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. -### Добавление React на сайт {#add-react-to-a-website} +### Добавляем React на сайт {#add-react-to-a-website} -Вы можете [добавить React на свой сайт буквально за одну минуту](/docs/add-react-to-a-website.html). После этого можно постепенно расширять использование React в своём проекте или ограничиться добавлением на страницу нескольких динамических элементов. +Вы можете [добавить React на свой сайт буквально за одну минуту](/docs/add-react-to-a-website.html). После этого можно разместить на сайте несколько динамических виджетов и постепенно наращивать использование React в своём проекте. ### Создание нового React-приложения {#create-a-new-react-app} -Когда вы начинаете проект на React, [то простая HTML страница с тегами script](/docs/add-react-to-a-website.html) может быть лучшим вариантом. Ведь для её создания вам потребуется меньше минуты. +Когда вы начинаете проект на 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 {#learn-react} +## Изучаем React {#learn-react} -Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения при изучении новых технологий: кто-то погружается в теорию, а кто-то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. +Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения в изучении новых технологий: кто-то погружается в теорию, а кто-то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. * Если вы предпочитаете **изучать технологии на практике**, начните с [введения](/tutorial/tutorial.html). * Если вам больше нравится **познавать предмет шаг за шагом**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). @@ -61,11 +61,11 @@ React изначально был спроектирован так, чтобы ### Простые примеры {#first-examples} -На [главной странице](/) есть несколько маленьких примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока абсолютно ничего не знаете о React, попробуйте что-нибудь поменять в коде этих примеров и посмотрите на результат. +На [главной странице](/) есть несколько простых примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока ничего не знаете о React, сделайте это. Попробуйте что-нибудь поменять в коде и посмотрите на результат. ### React для новичков {#react-for-beginners} -Если документация кажется вам сложной и усваивается не так быстро, как хотелось, взгляните на [обзор React, который сделала Таня Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). В нем Таня на простом языке подробно рассказала о наиболее важных концепциях React. Всё, что вам теперь нужно, это дать документации еще один шанс! +Если документация кажется вам сложной и усваивается не так быстро, как хотелось, прочтите [блог Тани Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). Таня написала о том, как начала работать с React и доходчиво рассказала об его основных принципах. Всё, что вам теперь нужно, это дать документации еще один шанс! ### React для дизайнеров {#react-for-designers} @@ -79,48 +79,48 @@ React изначально был спроектирован так, чтобы >Совет > ->Если всё-таки у вас остались пробелы в знаниях о JavaScript, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации чтобы пификсить их. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). +>Если всё-таки у вас есть пробелы в знаниях, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации о JavaScript. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). ### Введение {#practical-tutorial} -Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь [введением](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно пройдите это руководство. Технология, которую вы освоите, является фундаментом для разработки *любых* приложений на React. Она даст вам более глубокое понимание этой библиотеки. +Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь [введением](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно уделите внимание этому разделу документации. Технология, которую вы освоите — фундамент для разработки *любых* приложений на React. [Введение](/tutorial/tutorial.html) даст вам более глубокое понимание React. ### Подробное описание React {#step-by-step-guide} -Если вам больше нравится **познавать предмет шаг за шагом**, то лучше начать с [подробного описания основных принципов React](/docs/hello-world.html). Каждая последующая глава описания базируется на знаниях предыдущей, поэтому вы ничего не упстите в процессе изучения материала. +Если вам больше нравится **познавать предмет шаг за шагом**, то лучше начать с [подробного описания основных принципов React](/docs/hello-world.html). Каждая последующая глава описания базируется на знаниях предыдущей, поэтому вы ничего не упустите в процессе изучения материала. ### Мыслить в стиле React {#thinking-in-react} -Многие пользователи React отмечают, что прочтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "торкнул" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё в силе. +Многие пользователи React отмечают, что чтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "торкнул" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё актуально. ### Рекомендуемые курсы {#recommended-courses} -Иногда бывает так, что люди считаю книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для таких пользователей мы размещаем [список рекомендуемых ресурсов](/community/courses.html). Некоторые из них даже бесплатные. +Иногда бывает так, что люди считаю книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для таких пользователей мы разместили [список рекомендуемых ресурсов](/community/courses.html). Некоторые из них бесплатные. ### Углублённое изучение React {#advanced-concepts} -После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, вам захочется углубиться в более продвинутые разделы документации. В этих главах описан очень мощный, но не так часто используемый функционал React. Например, [context](/docs/context.html) и [refs](/docs/refs-and-the-dom.html). +После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан очень мощный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). ### API {#api-reference} -Этот раздел документации пригодится, когда вы будете изучать конкретные подробности об использовании React API. В частности, в главе [`React.Component` API](/docs/react-component.html) повествуется о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. +Этот раздел документации пригодится, когда вы будете изучать нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. ### Глоссарий и ЧаВо {#glossary-and-faq} -[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел ЧаВо, в котором есть короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). +[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел ЧаВо. В нём короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). -## Будьте в курсе {#staying-informed} +## Информация о релизах {#staying-informed} -[Блог о React](/blog/) это источник официальной информации от нашей команды об обновлениях. Все самые важные новости, включая описание изменений в релизах или списки нерекомендуемых к использованию функций, будут публиковаться здесь в первую очередь. +[Блог о React](/blog/) это источник официальной информации от нашей команды об обновлениях. Все самые важные новости, включая описание изменений в релизах или списки нерекомендуемых к использованию функций, публикуются в первую очередь здесь. Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter, но всё-таки, если вы не хотите пропустить что-нибудь по-настоящему важное, читайте блог. -В блоге мы пишем не о всех релизах React, но всегда есть возможность посмотреть список изменений для всех релизов [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). +В блоге мы пишем не о всех релизах React, однако всегда есть возможность посмотреть полный список изменений [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). -## Документация на прошлые версии React {#versioned-documentation} +## Документация на старые версии React {#versioned-documentation} -Документация на сайте всегда соответствует последнему стабильному релизу. Начиная с 16 версии React, мы публикуем старые версии документации [на отдельной странице](/versions). Учтите, что копии документации на прошлые версии создаются в момент выхода релиза и более не обновляются. +Документация на сайте всегда соответствует последнему стабильному релизу. Начиная с 16 версии React, мы публикуем старые версии документации [на отдельной странице](/versions). Учтите, что копии документации создаются в момент выхода релиза и более не обновляются. ## Обратная связь {#something-missing} -Если вы обнаружите в документации какие-нибудь неточности, ошибки или любые другие непонятки, пожаулйста, [создайте сообщение об ошибке в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! +Если вы обнаружите в документации какие-нибудь неточности, ошибки или любые другие непонятки, пожалуйста, [создайте сообщение об ошибке в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! From 61580fa8a9a1dbcd74f1df39fee70cce531077d2 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 20:18:24 +0500 Subject: [PATCH 05/11] Update getting-started.md --- content/docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 3392bed6b..6a60bdca0 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -44,7 +44,7 @@ React изначально был спроектирован так, чтобы Вы можете [добавить React на свой сайт буквально за одну минуту](/docs/add-react-to-a-website.html). После этого можно разместить на сайте несколько динамических виджетов и постепенно наращивать использование React в своём проекте. -### Создание нового React-приложения {#create-a-new-react-app} +### Создаём React-приложение {#create-a-new-react-app} Когда вы начинаете проект на React, [то простая HTML страница со script-тегами](/docs/add-react-to-a-website.html) может быть лучшим вариантом. Её можно сделать за минуту. From 174e4022c4b31d31cb86e64778016d8d120834a6 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Sun, 10 Feb 2019 20:34:05 +0500 Subject: [PATCH 06/11] Update getting-started.md --- content/docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 6a60bdca0..8ee63f4d8 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -101,7 +101,7 @@ React изначально был спроектирован так, чтобы После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан очень мощный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). -### API {#api-reference} +### Справочник API {#api-reference} Этот раздел документации пригодится, когда вы будете изучать нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. From daa0b22ef54700d8f78060658b08e7c4fecedad3 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Mon, 11 Feb 2019 00:27:02 +0500 Subject: [PATCH 07/11] Update getting-started.md --- content/docs/getting-started.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 8ee63f4d8..12c1f26fe 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -38,7 +38,7 @@ React изначально был спроектирован так, чтобы Если вы просто хотите немного поиграть с React, попробуйте онлайн-песочницу. Например, вот простейший шаблон на [CodePen](codepen://hello-world) или [CodeSandbox](https://codesandbox.io/s/new). -Если вы предпочитаете работать в своем редакторе, [скачайте тестовый HTML-файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавьте в него код и запустите на своем компьютере. В тестовом файле используется библиотека babel для преобразования кода React в обычный код на JavaScript. Это происходит налету непосредственно в вашем браузере. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. +Если вы предпочитаете работать в своем редакторе, [скачайте тестовый HTML-файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавьте в него код и запустите на своем компьютере. При открытии тестового файла браузер выполняет преобразование кода React в обычный код на JavaScript. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. ### Добавляем React на сайт {#add-react-to-a-website} @@ -48,24 +48,24 @@ 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 {#learn-react} -Люди начинают работать с React, имея за спиной свой собственный опыт и определенный уровень мастерства. При этом у каждого есть предпочтения в изучении новых технологий: кто-то погружается в теорию, а кто-то сразу переходит к решению практических задач. В любом случае мы надеемся, что этот раздел будет для вас полезен. +Люди приходят к React с разным опытом и стилем обучения. Некоторые предпочитают учиться на ходу, а кому-то нравится сначала овладеть теорией. В любом случае мы надеемся, что этот раздел будет для вас полезен. -* Если вы предпочитаете **изучать технологии на практике**, начните с [введения](/tutorial/tutorial.html). -* Если вам больше нравится **познавать предмет шаг за шагом**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). +* Если вам больше нравится **учиться на ходу**, начните с [введения](/tutorial/tutorial.html). +* Если вы хотите **сначала овладеть теорией**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). -Также как любые другие новые технологии React не имеет строго определенного направления изучения или последовательного учебного курса, однако, набравшись терпения и приложив достаточное усердие, вы *обязательно* освоите React. Терпение и труд все перетрут! +React сначала может показаться сложным, но приложив усилие, вы *обязательно* его освоите. Терпение и труд все перетрут! ### Простые примеры {#first-examples} -На [главной странице](/) есть несколько простых примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока ничего не знаете о React, сделайте это. Попробуйте что-нибудь поменять в коде и посмотрите на результат. +На [главной странице](/) есть несколько простых примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока ничего не знаете о React, попробуйте что-нибудь поменять в коде и посмотрите на результат. ### React для новичков {#react-for-beginners} -Если документация кажется вам сложной и усваивается не так быстро, как хотелось, прочтите [блог Тани Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). Таня написала о том, как начала работать с React и доходчиво рассказала об его основных принципах. Всё, что вам теперь нужно, это дать документации еще один шанс! +Если документация кажется вам сложной и усваивается не так быстро, как хотелось, прочтите [блог Тани Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). Таня написала о том, как начала работать с React и доходчиво рассказала об его основных принципах. Вдохновленные Таниным блогом вы можете снова приступить к изучению документации. ### React для дизайнеров {#react-for-designers} @@ -91,7 +91,7 @@ React изначально был спроектирован так, чтобы ### Мыслить в стиле React {#thinking-in-react} -Многие пользователи React отмечают, что чтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "торкнул" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё актуально. +Многие пользователи React отмечают, что чтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "обаял" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё актуально. ### Рекомендуемые курсы {#recommended-courses} @@ -99,15 +99,15 @@ React изначально был спроектирован так, чтобы ### Углублённое изучение React {#advanced-concepts} -После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан очень мощный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). +После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан полезный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). ### Справочник API {#api-reference} Этот раздел документации пригодится, когда вы будете изучать нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. -### Глоссарий и ЧаВо {#glossary-and-faq} +### Глоссарий и FAQ {#glossary-and-faq} -[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел ЧаВо. В нём короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). +[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел FAQ. В нём короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). ## Информация о релизах {#staying-informed} From fbed237b7ba968412976f3a7f165073aacabd3b3 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Mon, 11 Feb 2019 21:05:41 +0500 Subject: [PATCH 08/11] Update getting-started.md --- content/docs/getting-started.md | 40 ++++++++++++++++----------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 12c1f26fe..71706d5e4 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -20,7 +20,7 @@ redirect_from: На этой странице мы сделаем небольшой обзор документации и других ресурсов, которые могут пригодиться при первом использовании React. -**React** — это JavaScript-библиотека для разработки пользовательского интерфейса. Чтобы составить первое впечатление о React зайдите на [главную страницу](/) или во [введение](/tutorial/tutorial.html). +**React** — это JavaScript-библиотека для разработки пользовательского интерфейса. Чтобы составить первое впечатление о React, зайдите на [главную страницу](/) или во [введение](/tutorial/tutorial.html). --- @@ -38,7 +38,7 @@ React изначально был спроектирован так, чтобы Если вы просто хотите немного поиграть с React, попробуйте онлайн-песочницу. Например, вот простейший шаблон на [CodePen](codepen://hello-world) или [CodeSandbox](https://codesandbox.io/s/new). -Если вы предпочитаете работать в своем редакторе, [скачайте тестовый HTML-файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавьте в него код и запустите на своем компьютере. При открытии тестового файла браузер выполняет преобразование кода React в обычный код на JavaScript. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать данный файл только для простых демонстрационных примеров. +Если вы предпочитаете работать в своем редакторе, [скачайте тестовый HTML-файл](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), добавьте в него код и запустите на своем компьютере. При открытии тестового файла браузер преобразует JSX в обычный код на JavaScript. Такое преобразование достаточно медленно, поэтому мы рекомендуем использовать этот файл только для простых демонстрационных примеров. ### Добавляем React на сайт {#add-react-to-a-website} @@ -48,20 +48,20 @@ 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 {#learn-react} Люди приходят к React с разным опытом и стилем обучения. Некоторые предпочитают учиться на ходу, а кому-то нравится сначала овладеть теорией. В любом случае мы надеемся, что этот раздел будет для вас полезен. * Если вам больше нравится **учиться на ходу**, начните с [введения](/tutorial/tutorial.html). -* Если вы хотите **сначала овладеть теорией**, то начните с [подробного описания основных принципов React](/docs/hello-world.html). +* Если вы хотите **сначала овладеть теорией**, то начните с [пошагового описания React](/docs/hello-world.html). React сначала может показаться сложным, но приложив усилие, вы *обязательно* его освоите. Терпение и труд все перетрут! ### Простые примеры {#first-examples} -На [главной странице](/) есть несколько простых примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока ничего не знаете о React, попробуйте что-нибудь поменять в коде и посмотрите на результат. +На [главной странице](/) есть несколько простых примеров использования React. Их можно отредактировать и запустить прямо на нашем сайте. Даже если вы пока ничего не знаете о React, попробуйте что-нибудь поменять в коде и посмотрите на результат. ### React для новичков {#react-for-beginners} @@ -69,53 +69,53 @@ React сначала может показаться сложным, но при ### React для дизайнеров {#react-for-designers} -Если у вас есть дизайнерский опыт, то [этот сайт](http://reactfordesigners.com/) будет отличным местом, с которого вы сможете начать изучение React. +Если вы в первую очередь занимаетесь дизайном, вам могут пригодиться ресурсы, собранные [на этом сайте](http://reactfordesigners.com/). ### Ресурсы по JavaScript {#javascript-resources} -Изучение React предполагает наличие некоторых знаний о программировании на языке JavaScript. Вы не обязаны быть экспертом, но учтите, что для одновременного изучения и React, и JavaScript потребуется значительно больше времени. +Изучение React предполагает наличие некоторых знаний о программировании на языке JavaScript. Глубоких знаний не потребуется, но учить React и JavaScript одновременно может быть тяжело. Чтобы освежить ваши знания, мы рекомендуем просмотреть [обзор языка JavaScript на сайте mozilla.org](https://developer.mozilla.org/ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript). Для этого потребуется от 30 минут до часа. Надеемся, что теперь вы будете чувствовать себя более комфортно при изучении React. >Совет > ->Если всё-таки у вас есть пробелы в знаниях, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации о JavaScript. Также всегда можно задать вопрос или попросить помощи на [форуме нашего сообщества](/community/support.html). +>Если всё-таки у вас есть пробелы в знаниях, то сайты [MDN](https://developer.mozilla.org/ru/docs/Web/JavaScript) и [javascript.info](http://javascript.info/) будут отличными источниками информации о JavaScript. Также всегда можно задать вопрос или попросить помощи на [форумах нашего сообщества](/community/support.html). ### Введение {#practical-tutorial} -Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь [введением](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно уделите внимание этому разделу документации. Технология, которую вы освоите — фундамент для разработки *любых* приложений на React. [Введение](/tutorial/tutorial.html) даст вам более глубокое понимание React. +Если вы предпочитаете **изучать технологии на практике**, воспользуйтесь [введением](/tutorial/tutorial.html). В нём описан процесс разработки игры в крестики-нолики. Даже если вы не планируете программировать игры, всё равно уделите внимание этому разделу документации. Приёмы, которые вы освоите — фундамент для разработки *любых* приложений на React. [Введение](/tutorial/tutorial.html) даст вам более глубокое понимание React. -### Подробное описание React {#step-by-step-guide} +### Пошаговое описание React {#step-by-step-guide} -Если вам больше нравится **познавать предмет шаг за шагом**, то лучше начать с [подробного описания основных принципов React](/docs/hello-world.html). Каждая последующая глава описания базируется на знаниях предыдущей, поэтому вы ничего не упустите в процессе изучения материала. +Если вам больше нравится **познавать предмет шаг за шагом**, то лучше начать с [пошагового описания React](/docs/hello-world.html). Каждая последующая глава описания опирается на знания из предыдущей, поэтому вы ничего не упустите в процессе изучения материала. -### Мыслить в стиле React {#thinking-in-react} +### Философия React {#thinking-in-react} -Многие пользователи React отмечают, что чтение статьи [Мыслить в стиле React](/docs/thinking-in-react.html) стало именно тем моментом, когда React "обаял" их по-настоящему. Возможно это самое древнее руководство по React, но оно всё ещё актуально. +Многие пользователи React отмечают, что чтение статьи [Философия React](/docs/thinking-in-react.html) стало именно тем моментом, когда они решили использовать React. Может это и самое древнее руководство по React, но оно всё ещё актуально. ### Рекомендуемые курсы {#recommended-courses} -Иногда бывает так, что люди считаю книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для таких пользователей мы разместили [список рекомендуемых ресурсов](/community/courses.html). Некоторые из них бесплатные. +Некоторые пользователи считаю книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для них мы разместили [список рекомендуемых ресурсов](/community/courses.html). Часть этих ресурсов бесплатны. ### Углублённое изучение React {#advanced-concepts} -После того, как вы досконально изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан полезный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). +После того, как вы изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан полезный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). ### Справочник API {#api-reference} -Этот раздел документации пригодится, когда вы будете изучать нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. +Этот раздел документации описывает нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. ### Глоссарий и FAQ {#glossary-and-faq} -[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел FAQ. В нём короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). +[Глоссарий](/docs/glossary.html) содержит перечень наиболее употребляемых терминов, которые встречаются в документации. Также есть раздел FAQ. В нём короткие вопросы и ответы на самые животрепещущие темы, такие как [использование AJAX](/docs/faq-ajax.html), [состояние компонентов](/docs/faq-state.html) или [структура проекта](/docs/faq-structure.html). ## Информация о релизах {#staying-informed} -[Блог о React](/blog/) это источник официальной информации от нашей команды об обновлениях. Все самые важные новости, включая описание изменений в релизах или списки нерекомендуемых к использованию функций, публикуются в первую очередь здесь. +В [официальном блоге](/blog/) мы сообщаем о новых релизах React. Все самые важные новости, включая списки изменений и нерекомендуемых к использованию функций, публикуются в первую очередь здесь. -Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter, но всё-таки, если вы не хотите пропустить что-нибудь по-настоящему важное, читайте блог. +Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter. Однако вы не пропустите ничего важного, если будете следить только за блогом. -В блоге мы пишем не о всех релизах React, однако всегда есть возможность посмотреть полный список изменений [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). +В блоге мы пишем не о всех релизах React, но всегда есть возможность посмотреть полный список изменений [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). ## Документация на старые версии React {#versioned-documentation} From 31126886a344458814ada9686423351103b6af84 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Mon, 11 Feb 2019 21:10:11 +0500 Subject: [PATCH 09/11] Update getting-started.md --- 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 71706d5e4..ff4fc31cf 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -48,7 +48,7 @@ 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 {#learn-react} @@ -95,7 +95,7 @@ React сначала может показаться сложным, но при ### Рекомендуемые курсы {#recommended-courses} -Некоторые пользователи считаю книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для них мы разместили [список рекомендуемых ресурсов](/community/courses.html). Часть этих ресурсов бесплатны. +Некоторые пользователи считают книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для них мы разместили [список рекомендуемых ресурсов](/community/courses.html). Часть этих ресурсов бесплатны. ### Углублённое изучение React {#advanced-concepts} From 0ba16a9fce91434694057c8de3db66a5883474e3 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Mon, 11 Feb 2019 23:58:57 +0500 Subject: [PATCH 10/11] Update getting-started.md --- content/docs/getting-started.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index ff4fc31cf..4ffa8b1e9 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -46,9 +46,9 @@ React изначально был спроектирован так, чтобы ### Создаём React-приложение {#create-a-new-react-app} -Когда вы начинаете проект на React, [то простая HTML страница со script-тегами](/docs/add-react-to-a-website.html) может быть лучшим вариантом. Её можно сделать за минуту. +Когда вы начинаете проект на 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 {#learn-react} @@ -65,7 +65,7 @@ React сначала может показаться сложным, но при ### React для новичков {#react-for-beginners} -Если документация кажется вам сложной и усваивается не так быстро, как хотелось, прочтите [блог Тани Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). Таня написала о том, как начала работать с React и доходчиво рассказала об его основных принципах. Вдохновленные Таниным блогом вы можете снова приступить к изучению документации. +Если документация кажется вам сложной и усваивается не так быстро, как хотелось, прочтите [блог Тани Раша (Tania Rascia)](https://www.taniarascia.com/getting-started-with-react/). Таня написала о том, как начала работать с React и доходчиво рассказала об его основных принципах. Попробуйте почитать этот пост, а потом вернуться к документации. ### React для дизайнеров {#react-for-designers} @@ -75,7 +75,7 @@ React сначала может показаться сложным, но при Изучение React предполагает наличие некоторых знаний о программировании на языке JavaScript. Глубоких знаний не потребуется, но учить React и JavaScript одновременно может быть тяжело. -Чтобы освежить ваши знания, мы рекомендуем просмотреть [обзор языка JavaScript на сайте mozilla.org](https://developer.mozilla.org/ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript). Для этого потребуется от 30 минут до часа. Надеемся, что теперь вы будете чувствовать себя более комфортно при изучении React. +Чтобы освежить ваши знания, мы рекомендуем просмотреть [обзор языка JavaScript на сайте mozilla.org](https://developer.mozilla.org/ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript). Для этого потребуется от 30 минут до часа. Надеемся, что теперь вы будете чувствовать себя более комфортно, изучая React. >Совет > @@ -91,19 +91,19 @@ React сначала может показаться сложным, но при ### Философия React {#thinking-in-react} -Многие пользователи React отмечают, что чтение статьи [Философия React](/docs/thinking-in-react.html) стало именно тем моментом, когда они решили использовать React. Может это и самое древнее руководство по React, но оно всё ещё актуально. +Многие вспоминают, как чтение [Философии React](/docs/thinking-in-react.html) поставило всё на свои места. Пускай это и самое древнее руководство по React, но оно всё так же актуально. ### Рекомендуемые курсы {#recommended-courses} -Некоторые пользователи считают книги или видеокурсы от сторонних авторов более полезными, нежели официальная документация. Для них мы разместили [список рекомендуемых ресурсов](/community/courses.html). Часть этих ресурсов бесплатны. +Некоторым больше нравится учиться по книгам или видеокурсам от сторонних авторов, а не по официальной документации. Для них мы разместили [список рекомендуемых ресурсов](/community/courses.html). Часть этих ресурсов бесплатны. ### Углублённое изучение React {#advanced-concepts} -После того, как вы изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые разделы документации. В этих главах описан полезный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). +После того, как вы изучите [основные принципы React](#main-concepts) и немного поиграетесь с ним, можно углубиться в более продвинутые темы документации. В этих главах описан полезный, но не так часто используемый функционал React. Например, [контекст](/docs/context.html) и [рефы](/docs/refs-and-the-dom.html). ### Справочник API {#api-reference} -Этот раздел документации описывает нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и о различных методах управления жизненным циклом компонентов. +Этот раздел документации описывает нюансы использования React API. Например, в главе [`React.Component` API](/docs/react-component.html) рассказывается о работе функции `setState()` и различных методах управления жизненным циклом компонентов. ### Глоссарий и FAQ {#glossary-and-faq} @@ -115,11 +115,11 @@ React сначала может показаться сложным, но при Также вы можете подписаться на наш аккаунт [@reactjs](https://twitter.com/reactjs) в Twitter. Однако вы не пропустите ничего важного, если будете следить только за блогом. -В блоге мы пишем не о всех релизах React, но всегда есть возможность посмотреть полный список изменений [в файле `CHANGELOG.md` в репоизтории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). +В блоге мы пишем не о всех релизах React, но всегда есть возможность посмотреть полный список изменений [в файле `CHANGELOG.md` в репозитории React](https://github.com/facebook/react/blob/master/CHANGELOG.md), а также на странице [Релизы](https://github.com/facebook/react). ## Документация на старые версии React {#versioned-documentation} -Документация на сайте всегда соответствует последнему стабильному релизу. Начиная с 16 версии React, мы публикуем старые версии документации [на отдельной странице](/versions). Учтите, что копии документации создаются в момент выхода релиза и более не обновляются. +Документация на сайте всегда соответствует последнему стабильному релизу. Начиная с 16 версии React, мы публикуем старые версии документации [на отдельной странице](/versions). Учтите, что копии документации создаются в момент выхода релиза и больше не обновляются. ## Обратная связь {#something-missing} From 622dbcef58c0c4fe16e257bff6be8ccd5a01eb08 Mon Sep 17 00:00:00 2001 From: AlLevykin Date: Tue, 12 Feb 2019 00:01:49 +0500 Subject: [PATCH 11/11] Update getting-started.md --- content/docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 4ffa8b1e9..e8ce2a8bb 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -123,4 +123,4 @@ React сначала может показаться сложным, но при ## Обратная связь {#something-missing} -Если вы обнаружите в документации какие-нибудь неточности, ошибки или любые другие непонятки, пожалуйста, [создайте сообщение об ошибке в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас! +Если вы обнаружите в документации какие-нибудь неточности, ошибки или любые другие непонятки, пожалуйста, [создайте ишью в репозитории документации](https://github.com/reactjs/reactjs.org/issues/new) с указанием способа решения проблемы или просто [чирикните нам в Twitter @reactjs](https://twitter.com/reactjs). Мы всегда рады слышать вас!