Skip to content
This repository has been archived by the owner on Jan 4, 2022. It is now read-only.

Latest commit

 

History

History
158 lines (89 loc) · 14.4 KB

CONTRIBUTING.md

File metadata and controls

158 lines (89 loc) · 14.4 KB
Read these guidelines in English عربى 中文 Português русский Español

Рекомендации по внесению вклада в freeCodeCamp

Привет, 👋!

freeCodeCamp.org возможен благодаря тысячам добровольцев, таких как вы. Мы благодарим за Ваш вклад, и мы рады приветствовать Вас на борту.

Мы строго соблюдаем наш «Кодекс поведения»: "Code of Conduct". Потратьте минутку, чтобы ознакомиться. Это не займет много времени.

Счастливого участия 🎉!

Вот некоторые интересные способы, которыми вы можете помочь

Вы можете внести свой вклад в интересующую вас область:

  1. Внести вклад в этот открытый репозиторий.

    Помогите нам в создании или редактировании Обучающих статей, задачи на кодирование и исправление ошибок на обучающей платформе.

  2. Помощь новичкам с нашим форумом.

  3. Помогите нам добавить субтитры на нашем канале YouTube.

Внести свой вклад в этот open source проект

У нас есть огромная база с открытым исходным кодом из тысяч задач на кодирование и Обучающие статьи. Эти задачи и статьи составляют учебный контент, доступный на платформе обучения freeCodeCamp.org.

Вы можете помочь нам:

Изучение, написание и обновление статей нашего руководства

Что за обучающие статьи?

Обучающие статьи помогут вам быстро понять технологические концепции. Это краткие и простые объяснения, которые вы можете прочитать, прежде чем перейти к более глубоким темам.

Пример стати о HTML.

О чем я могу написать статью?

Мы рады Вашей помощи с написаниием этих статей. Вам не обязательно быть экспертом в теме, чтобы писать об этом - все это Руководство является открытым исходным кодом, поэтому, даже если вы допустили ошибку, другой участник в конечном итоге исправит это.

Чтобы помочь, найдите «заглушку» на нашем Сайте Руководства, напишите статью, затем создайте 'pull request', чтобы заменить заглушку своей статьей. pull request это как Вы можете предложить изменения. Это позволяет другим узнать о ваших изменениях, просмотреть их и принять их.

Если вы не можете найти заглушку по теме, о которой хотите писать, вы можете открыть PR, который создает заглушку и включает черновик Вашей статьи.

** Если вы хотите работать над этим, следуйте этим рекомендациям: **

Создание, обновление и исправление ошибок в наших задачах на кодирование

Все наши задачи на кодирование пишутся сообществом, принося экспертные знания таких добровольцев, как Вы.

Тем не менее, их необходимо постоянно совершенствовать по качеству. Например, вы можете обновить инструкции, чтобы исправить их пустословие Вы можете дополнить user stories, чтобы лучше объяснить концепцию и даже удалить лишнее. Вы можете захотеть рефакторить тесты, которые не проходят с текущим кодом для user stories.

** Если вы хотите работать над этим, следуйте этим рекомендациям: **

Перевод статей руководства и задач на кодирование

Вы можете помочь нам с переводом наших статей и задач на кодирование для языка, на котором вы говорите. В настоящее время мы переводим версии в:

  • Chinese (中文)
  • Russian (русский)
  • Arabic (عربى)
  • Spanish (Español)
  • Portuguese (Português)

Большинство из этих версий переведены машиной. Мы будем рады вашей помощи в улучшении качества этих переводов.

** Если вы хотите работать над этим, следуйте этим рекомендациям: **

[TODO] We are in the process of updating docs for the translation workflow. Follow #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 или Stuart Taylor @bouncey из нашей команды разработчиков платформы, чтобы помочь вам разобраться.

** Если вы хотите работать над этим, следуйте этим рекомендациям: **

Часто задаваемые вопросы

Как я могу сообщить об ошибке, которой не в списке?

Если вы считаете, что обнаружили ошибку, сначала прочитайте "Помощь Я нашел ошибку" article and follow its instructions.

Если вы уверены, что это новая ошибка, продолжайте и создайте новую проблему GitHub.Обязательно укажите как можно больше информации, чтобы мы могли воспроизвести ошибку. У нас есть предопределенный шаблон, который поможет вам в этом.

Обратите внимание, что любые вопросы, требующие помощи по задачам на кодирование, будут закрыты. Отслеживание проблем строго связано с вопросами и обсуждениями, связанными с кодовой базой. Вам лучше искать помощь на форуме перед тем как сообщать о любых сомнениях.

Как я могу сообщить о проблеме безопасности?

Пожалуйста, не создавайте проблемы GitHub для проблем безопасности. Вместо этого отправьте электронное письмо по адресу security@freecodecamp.org и мы рассмотрим его немедленно.

** Я застрял над тем, чего нет в этой документации. Как получить помощь? **

Не стесняйтесь обращаться за помощью в:

Мы рады помочь вам внести свой вклад в любую из тем, над которыми вы хотели бы работать. Перед отправкой нового вопроса убедитесь, что его не сделал кто-то до вас. Будьте вежливы и терпеливы. Наши волонтеры и модераторы сообщества всегда рядом, чтобы ответить на ваши вопросы.

** Я новичок в GitHub и Open Source в целом: **

Читайте наше Руководство о внесении вклада в проекты с открытым исходным кодом.

** Что означают эти разные ярлыки, которые отмечены проблемы? **

Наши модераторы сообщества сортируют проблемы и вытягивать запросы на основе их приоритета, серьезности и других факторов. Вы можете найти полный глоссарий их значений здесь.

Вы должны искать Нужна Помощь Help Wanted или Новички приветствовуются first timers welcome для быстрого поиска того, что доступно для вас. Они готовы к работе, и вам не нужно ничего делать прежде чем начать работать над ними.

Если в этих вопросах не хватает ясности в отношении того, что нужно сделать, не стесняйтесь задавать вопросы в комментариях.

** Я нашел опечатку, должен ли я сообщить о проблеме, прежде чем я смогу сделать запрос на дополнение, 'pull request'? **

Вы можете сразу создать pull request, не сообщая о каких-либо проблемах, для опечаток или небольших изменений в пустословие. Трекер Проблем - это инструмент для поиска подтверждения изменений, которые вы хотели бы предложить посредством pull request.