Skip to content

Latest commit

 

History

History
159 lines (88 loc) · 14.6 KB

CONTRIBUTING.md

File metadata and controls

159 lines (88 loc) · 14.6 KB
Read these guidelines in English 中文 русский عربي Español Português

Рекомендации по внесению вклада в 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] Мы находимся в процессе обновления документов для рабочего процесса перевода. Следите #18313 за прогрессом.

Помогите нам исправить ошибки в обучающей платформе freeCodeCamp.org

Наша обучающая платформа работает на современном стеке JavaScript. Он использует различные компоненты, инструменты и библиотеки, включая, но не ограничиваясь Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack, и другие.

В общем смысле,

  • У нас есть сервер с API на Node.js.
  • Набор клиентских приложений на основе React.
  • Скрипт, который мы используем для оценки проектов Frontend.

Для этого требуется некоторое понимание API, синтаксиса ES6 и много любопытства.

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

Не стесняйтесь задавать нам вопросы, о связанных проблемах, и мы будем рады прояснить. Когда вы сомневаетесь, вы можете связаться с Mrugesh Mohapatra @raisedadead или Stuart Taylor @bouncey из нашей команды разработчиков платформы, чтобы помочь вам разобраться.

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

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

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

Если вы считаете, что обнаружили ошибку, сначала прочитайте 'Помощь Я нашел ошибку' статью и следуйте инструкциям.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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