Участие в развитии MDN
MDN Web Docs нужна ваша помощь! У нас есть много опечаток и ошибок для исправления, примеров для написания, людей, с которыми можно поговорить и много чего другого. Количество всего этого растёт вместе с количеством людей, использующих сайт. На этой странице рассказывается, что вы можете сделать, чтобы помочь.
Примечание: Если вы никогда до этого не вносили вклад в MDN, статья начало работы объяснит процесс в четырёх простых шагах. Если вы читаете это сообщение, для вас есть хорошая новость — вы уже на шаге 3: "Узнайте, как вы можете помочь"!
Чем я могу помочь?
Есть несколько способов поучаствовать в развитии MDN в зависимости от ваших навыков и интересов. Вместе с каждой задачей мы предоставляем короткое описание и примерное время, которое она занимает.
Если вы не уверены, что делать, вы всегда можете попросить о помощи.
Основные виды помощи
Ссылки в этом разделе ведут к подробным руководствам, объясняющим как выполнить задачи, в которых мы больше всего заинтересованы при получении помощи от сообщества, потому что они являются важными функциями и/или с ними связано большое отставание. Пожалуйста, подумайте о возможности помочь нам с этими задачами, прежде чем рассматривать возможность внести свой вклад другими способами.
Задачи | Описание | Необходимые навыки |
---|---|---|
Исправление ошибок в контенте MDN (en-US) | Это наш репозиторий контента, в котором люди сообщают о проблемах найденных в документации MDN (вы так же можете найти ошибки в старом репозитории sprints, но в конечном счёте мы его закроем). Мы получаем очень много ошибок, связанных с контентом, и мы будем признательны за любую помощь, которую вы можете оказать в их исправлении. |
|
Ревью правок MDN | Люди постоянно отправляют пулреквесты в наш репозиторий контента для обновления MDN, и нам нужна помощь в их ревью. Посмотрите страницу REVIEWING.md, чтобы узнать как проходит процесс ревью и какую помощь вы можете оказать. |
|
Помощь новичкам в учёбе на MDN (en-US) | Наши страницы «Изучение веб-разработки» просматриваются более миллиона раз в месяц и имеют активные форумы, куда люди обращаются за помощью или просят оценить их работу. Мы рады помощи с ответами на задаваемые вопросы и помощи в развитии нашего сообщества учеников. |
|
Со временем мы добавим сюда больше задач.
Приоритеты
Также вы можете посмотреть приоритеты, чтобы понять, какая работа является более важной — мы начали добавлять к ошибкам контента метки P0, P1, P2, P3, и P4 чтобы обозначит их важность, при этом меньшие числа важнее, чем большие.
Они определяются в процессе сортировки ошибок MDN, основанном на списке приоритетов документации MDN.
Другие типы задач
Если наши основные приоритеты, приведённые выше, вас не интересуют, вы можете найти ряд других, более общих типов задач, приведённых ниже и разделённых по необходимым наборам навыков.
Если вас интересуют слова, то мы можете:
- Обновить существующую статью новой информацией (5 минут-1 час)
- Создать новую запись в Глоссарии (15 минут-1 час)
Если вас больше интересует код, то вы можете:
- Преобразовать примеры в "живые" (30 минут)
- Прислать патч в кодовую базу Yari (1 час)
- Написать интерактивный пример (1 час)
Если вам интересны слова и код, то вы можете:
- Написать или обновить справочник по API (en-US) (от 30 минут до 2 часов, или больше)
- Написать новую статью на знакомую вам тему (1 час и больше)
- Добавить или обновить данные о совместимости браузеров (en-US) (от 30 минут до 1 часа)
Примечание: Если обнаружили что-то неправильное в MDN, но не уверены в том, как это исправить, вы можете сообщить о проблеме с помощью оформления ишью. Пожалуйста, дайте ишью описательный заголовок. (Бесполезно говорить: "мертвая ссылка", не говоря, где вы нашли эту ссылку.
Другие полезные страницы
- Mozilla - Быстрый старт!
Мы — открытое сообщество разработчиков, которые создают ресурсы для лучшего Веба, не зависящего от брендов, браузеров или платформ. В этом деле нам может помочь любой желающий, делая сильнее всё наше сообщество. Вместе мы будем развивать инновации в Вебе для всеобщего блага. Это начинается прямо здесь, вместе с вами.
- Локализация MDN Web Docs
С 14 декабря 2020 года MDN работает на новой платформе Yari на базе GitHub. У такого подхода много преимуществ для MDN, однако нам необходимо внести радикальные изменения в способ управления локализацией. Это связано с тем, что в наших неанглоязычных разделах накопилось много устаревшего и неподдерживаемого контента, и мы хотим улучшить ситуацию в будущем.