Участие в развитии MDN

MDN Web Docs нужна ваша помощь! У нас есть много опечаток и ошибок для исправления, примеров для написания, людей, с которыми можно поговорить и много чего другого. Количество всего этого растёт вместе с количеством людей, использующих сайт. На этой странице рассказывается, что вы можете сделать, чтобы помочь.

Примечание: Если вы никогда до этого не вносили вклад в MDN, статья начало работы объяснит процесс в четырёх простых шагах. Если вы читаете это сообщение, для вас есть хорошая новость — вы уже на шаге 3: "Узнайте, как вы можете помочь"!

Чем я могу помочь?

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

Если вы не уверены, что делать, вы всегда можете попросить о помощи.

Основные виды помощи

Ссылки в этом разделе ведут к подробным руководствам, объясняющим как выполнить задачи, в которых мы больше всего заинтересованы при получении помощи от сообщества, потому что они являются важными функциями и/или с ними связано большое отставание. Пожалуйста, подумайте о возможности помочь нам с этими задачами, прежде чем рассматривать возможность внести свой вклад другими способами.

Задачи Описание Необходимые навыки
Исправление ошибок в контенте MDN Это наш репозиторий контента, в котором люди сообщают о проблемах найденных в документации MDN (вы так же можете найти ошибки в старом репозитории sprints, но в конечном счёте мы его закроем). Мы получаем очень много ошибок, связанных с контентом, и мы будем признательны за любую помощь, которую вы можете оказать в их исправлении.
  • Знание веб-технологий, с которыми вы хотите помочь (например, JavaScript, CSS).
  • Приемлемое знание английского языка (не беспокойтесь, если ваш английской не идеален: мы можем помочь с этим). 
Ревью правок MDN Люди постоянно отправляют пулреквесты в наш репозиторий контента для обновления MDN, и нам нужна помощь в их ревью. Посмотрите страницу REVIEWING.md, чтобы узнать как проходит процесс ревью и какую помощь вы можете оказать.
  • Знание веб-технологий, с которыми вы хотите помочь (например, JavaScript, CSS).
  • Приемлемое знание английского языка (не беспокойтесь, если ваш английской не идеален: мы можем помочь с этим). 
Помощь новичкам в учёбе на MDN Наши страницы «Изучение веб-разработки» просматриваются более миллиона раз в месяц и имеют активные форумы, куда люди обращаются за помощью или просят оценить их работу. Мы рады помощи с ответами на задаваемые вопросы и помощи в развитии нашего сообщества учеников.
  • Знание веб-технологий, с которыми вы хотите помочь (например, JavaScript, CSS).
  • Энтузиазм в объяснении технических тем и помощи новичками в изучении программирования.
  • Достаточное владение английским языком: он действительно не должен быть идеальным.

Со временем мы добавим сюда больше задач.

Приоритеты

Также вы можете посмотреть приоритеты, чтобы понять, какая работа является более важной — мы начали добавлять к ошибкам контента метки P0, P1, P2, P3, и P4 чтобы обозначит их важность, при этом меньшие числа важнее, чем большие.

Они определяются в процессе сортировки ошибок MDN, основанном на списке приоритетов документации MDN.

Другие типы задач

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

Если вас интересуют слова, то мы можете:

Если вас больше интересует код, то вы можете:

Если вам интересны слова и код, то вы можете:

Примечание: Если обнаружили что-то неправильное в MDN, но не уверены в том, как это исправить, вы можете сообщить о проблеме с помощью оформления ишью. Пожалуйста, дайте ишью описательный заголовок. (Бесполезно говорить: "мертвая ссылка", не говоря, где вы нашли эту ссылку.

Другие полезные страницы

Mozilla - Быстрый старт!
Основы этикета для проектов с открытым исходным кодом
Если вы раньше не работали над проектом с открытым исходным кодом (OSP), хорошая идея прочитать эту статью, прежде чем начинать вносить свой вклад в MDN (или другие проекты с открытым исходным кодом). Есть несколько хороших способов, которые помогут вам и другим участникам проекта чувствовать себя ценными и в безопасности, а также оставаться продуктивными.
Отправить отзыв об MDN
Если у вас есть предложения или проблемы с использованием MDN, то это нужное вам место. Тот факт, что у вас есть предложения сделать MDN лучше, делает вас частью большого сообщества MDN и мы благодарим вас за ваш интерес.
Процессы документирования
Проектная документация МДН необъятна; существует огромное количество технологий, реализуемые при помощи сотен участников со всего мира. Чтобы помочь нам навести порядок в этом хаосе, имеются стандартные процессы при работе с конкретными документационно-связанными задачами. Здесь вы найдёте руководства к этим процессам.
Руководства "Как сделать"
Эти статьи являются пошаговым руководством для достижения специфических целей при участии в MDN.