diff --git a/docs/russian/CONTRIBUTING.md b/docs/russian/CONTRIBUTING.md index 6413201ac3..2a7b98b74c 100644 --- a/docs/russian/CONTRIBUTING.md +++ b/docs/russian/CONTRIBUTING.md @@ -1,17 +1,158 @@ + - - - + + +
Read these guidelines in English 中文 русский عربى Español 中文 Português русский Español
-# Contribution Guidelines +# Рекомендации по внесению вклада в freeCodeCamp -Hello 👋 ! +Привет, 👋! -These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312) \ No newline at end of file +freeCodeCamp.org возможен благодаря тысячам добровольцев, таких как вы. Мы благодарим за Ваш вклад, и мы рады приветствовать Вас на борту. + +Мы строго соблюдаем наш «Кодекс поведения»: ["Code of Conduct"](https://www.freecodecamp.org/code-of-conduct). Потратьте минутку, чтобы ознакомиться. Это не займет много времени. + +Счастливого участия 🎉! + +## Вот некоторые интересные способы, которыми вы можете помочь + +Вы можете внести свой вклад в интересующую вас область: + +1. [Внести вклад в этот открытый репозиторий.](#contribute-to-this-open-source-codebase) + + Помогите нам в создании или редактировании [Обучающих статей](https://www.freecodecamp.org/guide), [задачи на кодирование](https://www.freecodecamp.org/learn) и исправление ошибок на обучающей платформе. + +2. Помощь новичкам с нашим [форумом](https://www.freecodecamp.org/forum/). + + - ❓ Помощь новичкам [отвечая на их вопросы](https://www.freecodecamp.org/forum/?max_posts=1). + - 💬 [Дать обратную связь](https://www.freecodecamp.org/forum/c/project-feedback?max_posts=1) на проекты новичков. + +3. Помогите нам добавить субтитры на нашем [канале YouTube](https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos). + + +## Внести свой вклад в этот open source проект + +У нас есть огромная база с открытым исходным кодом из тысяч [задач на кодирование](https://www.freecodecamp.org/learn) и [Обучающие статьи](https://www.freecodecamp.org/guide). Эти задачи и статьи составляют учебный контент, доступный на платформе обучения freeCodeCamp.org. + +Вы можете помочь нам: + +- [📝 В изучении, написании и обновлении статей нашего руководства.](#research-write-and-update-our-guide-articles) + +- [💻 В создании, обновлении и исправлении ошибок в наших задачах на кодирование.](#create-update-and-fix-bugs-in-our-curriculum-challenges) + +- [🌐 В переводе обучающих статей и задач на кодирование.](#translate-guide-articles-and-curriculum-challenges) + +- [🛠 Помочь нам в исправлении ошибок на обучающей платформе freeCodeCamp.org](#help-us-fix-bugs-in-freecodecamporgs-learning-platform) + +### Изучение, написание и обновление статей нашего руководства + +**Что за обучающие статьи?** + +Обучающие статьи помогут вам быстро понять технологические концепции. Это краткие и простые объяснения, которые вы можете прочитать, прежде чем перейти к более глубоким темам. + +Пример [стати о HTML](./client/src/pages/html/elements/index.md). + +**О чем я могу написать статью?** + +Мы рады Вашей помощи с написаниием этих статей. Вам не обязательно быть экспертом в теме, чтобы писать об этом - все это Руководство является открытым исходным кодом, поэтому, даже если вы допустили ошибку, другой участник в конечном итоге исправит это. + +Чтобы помочь, найдите «заглушку» на нашем [Сайте Руководства](https://www.freecodecamp.org/guide), напишите статью, затем создайте 'pull request', чтобы заменить заглушку своей статьей. [pull request](https://help.github.com/articles/about-pull-requests/) это как Вы можете предложить изменения. Это позволяет другим узнать о ваших изменениях, просмотреть их и принять их. + +Если вы не можете найти заглушку по теме, о которой хотите писать, вы можете открыть PR, который создает заглушку и включает черновик Вашей статьи. + +** Если вы хотите работать над этим, следуйте этим рекомендациям: ** + +#### [How to work on Guide articles.](/docs/how-to-work-on-guide-articles.md) + +### Создание, обновление и исправление ошибок в наших задачах на кодирование + +Все наши задачи на кодирование пишутся сообществом, принося экспертные знания таких добровольцев, как Вы. + +Тем не менее, их необходимо постоянно совершенствовать по качеству. Например, вы можете обновить инструкции, чтобы исправить их [пустословие](https://en.oxforddictionaries.com/definition/verbiage) Вы можете дополнить user stories, чтобы лучше объяснить концепцию и даже удалить лишнее. Вы можете захотеть рефакторить тесты, которые не проходят с текущим кодом для user stories. + +** Если вы хотите работать над этим, следуйте этим рекомендациям: ** + +#### [How to work on Coding Challenges.](/docs/how-to-work-on-coding-challenges.md) + +### Перевод статей руководства и задач на кодирование + +Вы можете помочь нам с переводом наших статей и задач на кодирование для языка, на котором вы говорите. В настоящее время мы переводим версии в: + +- Chinese (中文) +- Russian (русский) +- Arabic (عربى) +- Spanish (Español) +- Portuguese (Português) + +Большинство из этих версий переведены машиной. Мы будем рады вашей помощи в улучшении качества этих переводов. + +** Если вы хотите работать над этим, следуйте этим рекомендациям: ** + +**[TODO]** We are in the process of updating docs for the translation workflow. Follow [`#18313`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18313) for the progress. + +### Помогите нам исправить ошибки в обучающей платформе freeCodeCamp.org + +Наша обучающая платформа работает на современном стеке JavaScript. Он использует различные компоненты, инструменты и библиотеки, включая, но не ограничиваясь Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack, и другие. + +В общем смысле, + +- У нас есть сервер с API на Node.js. +- Набор клиентских приложений на основе React. +- A script that we use to use evaluate our Frontend projects. +- Скрипт, который мы используем для оценки проектов Frontend. + +Для этого требуется некоторое понимание API, синтаксиса ES6 и много любопытства. + +Мы ожидаем некоторых базовых знания с некоторыми из вышеупомянутых технологий, инструментов и библиотек. Тем не менее, вы не обязаны быть в этом экспертом. + +Не стесняйтесь задавать нам вопросы, о связанных проблемах, и мы будем рады прояснить. Когда вы сомневаетесь, вы можете связаться с Mrugesh Mohapatra [`@raisedadead`](https://github.com/raisedadead) или Stuart Taylor [`@bouncey`](https://github.com/bouncey) из нашей команды разработчиков платформы, чтобы помочь вам разобраться. + +** Если вы хотите работать над этим, следуйте этим рекомендациям: ** + +#### [Как настроить freeCodeCamp локально.](/docs/how-to-setup-freecodecamp-locally.md) + +## Часто задаваемые вопросы + +**Как я могу сообщить об ошибке, которой не в списке?** + +Если вы считаете, что обнаружили ошибку, сначала прочитайте ["Помощь Я нашел ошибку"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543) article and follow its instructions. + +Если вы уверены, что это новая ошибка, продолжайте и создайте новую проблему GitHub.Обязательно укажите как можно больше информации, чтобы мы могли воспроизвести ошибку. У нас есть предопределенный шаблон, который поможет вам в этом. + +Обратите внимание, что любые вопросы, требующие помощи по задачам на кодирование, будут закрыты. Отслеживание проблем строго связано с вопросами и обсуждениями, связанными с кодовой базой. Вам лучше [искать помощь на форуме](https://www.freecodecamp.org/forum) перед тем как сообщать о любых сомнениях. + +**Как я могу сообщить о проблеме безопасности?** + +Пожалуйста, не создавайте проблемы GitHub для проблем безопасности. Вместо этого отправьте электронное письмо по адресу `security@freecodecamp.org` и мы рассмотрим его немедленно. + +** Я застрял над тем, чего нет в этой документации. Как получить помощь? ** + +Не стесняйтесь обращаться за помощью в: + +- [Категория «Участники» на нашем форуме](https://www.freecodecamp.org/forum/c/contributors). +- [Наш чат в Gitter](https://gitter.im/FreeCodeCamp/Contributors). + +Мы рады помочь вам внести свой вклад в любую из тем, над которыми вы хотели бы работать. Перед отправкой нового вопроса убедитесь, что его не сделал кто-то до вас. Будьте вежливы и терпеливы. Наши волонтеры и модераторы сообщества всегда рядом, чтобы ответить на ваши вопросы. + +** Я новичок в GitHub и Open Source в целом: ** + +Читайте наше [Руководство о внесении вклада в проекты с открытым исходным кодом](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). + +** Что означают эти разные ярлыки, которые отмечены проблемы? ** + +Наши модераторы сообщества [сортируют](https://en.wikipedia.org/wiki/Software_bug#Bug_management) проблемы и вытягивать запросы на основе их приоритета, серьезности и других факторов. Вы можете [найти полный глоссарий их значений здесь](https://github.com/freecodecamp/freecodecamp/labels). + +Вы должны искать Нужна Помощь **`Help Wanted`** или Новички приветствовуются **`first timers welcome`** для быстрого поиска того, что доступно для вас. Они готовы к работе, и вам не нужно ничего делать прежде чем начать работать над ними. + +Если в этих вопросах не хватает ясности в отношении того, что нужно сделать, не стесняйтесь задавать вопросы в комментариях. + +** Я нашел опечатку, должен ли я сообщить о проблеме, прежде чем я смогу сделать запрос на дополнение, 'pull request'? ** + +Вы можете сразу создать pull request, не сообщая о каких-либо проблемах, для опечаток или небольших изменений в [пустословие](https://en.oxforddictionaries.com/definition/verbiage). Трекер Проблем - это инструмент для поиска подтверждения изменений, которые вы хотели бы предложить посредством pull request.