Участие в развитии MDN
MDN Web Docs нужна ваша помощь! У нас есть много опечаток и ошибок для исправления, примеров для написания, людей, с которыми можно поговорить и много чего другого. Количество всего этого растёт вместе с количеством людей, использующих сайт. На этой странице рассказывается, что вы можете сделать, чтобы помочь.
Примечание: Если вы никогда до этого не вносили вклад в MDN, статья начало работы объяснит процесс в четырёх простых шагах. Если вы читаете это сообщение, для вас есть хорошая новость — вы уже на шаге 3: "Узнайте, как вы можете помочь"!
Чем я могу помочь?
Есть несколько способов поучаствовать в развитии MDN в зависимости от ваших навыков и интересов. Вместе с каждой задачей мы предоставляем короткое описание и примерное время, которое она занимает.
Если вы не уверены, что делать, вы всегда можете попросить о помощи.
Основные виды помощи
Ссылки в этом разделе ведут к подробным руководствам, объясняющим как выполнить задачи, в которых мы больше всего заинтересованы при получении помощи от сообщества, потому что они являются важными функциями и/или с ними связано большое отставание. Пожалуйста, подумайте о возможности помочь нам с этими задачами, прежде чем рассматривать возможность внести свой вклад другими способами.
| Задачи | Описание | Необходимые навыки |
|---|---|---|
| Исправление ошибок в контенте MDN | Это наш репозиторий контента, в котором люди сообщают о проблемах найденных в документации MDN (вы так же можете найти ошибки в старом репозитории sprints, но в конечном счёте мы его закроем). Мы получаем очень много ошибок, связанных с контентом, и мы будем признательны за любую помощь, которую вы можете оказать в их исправлении. |
|
| Ревью правок MDN | Люди постоянно отправляют пулреквесты в наш репозиторий контента для обновления MDN, и нам нужна помощь в их ревью. Посмотрите страницу REVIEWING.md, чтобы узнать как проходит процесс ревью и какую помощь вы можете оказать. |
|
| Помощь новичкам в учёбе на MDN | Наши страницы «Изучение веб-разработки» просматриваются более миллиона раз в месяц и имеют активные форумы, куда люди обращаются за помощью или просят оценить их работу. Мы рады помощи с ответами на задаваемые вопросы и помощи в развитии нашего сообщества учеников. |
|
Со временем мы добавим сюда больше задач.
Приоритеты
Также вы можете посмотреть приоритеты, чтобы понять, какая работа является более важной — мы начали добавлять к ошибкам контента метки 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, но не уверены в том, как это исправить, вы можете сообщить о проблеме с помощью оформления ишью. Пожалуйста, дайте ишью описательный заголовок. (Бесполезно говорить: "мертвая ссылка", не говоря, где вы нашли эту ссылку.
Другие полезные страницы
- Процессы документирования
Проектная документация МДН необъятна; существует огромное количество технологий, реализуемые при помощи сотен участников со всего мира. Чтобы помочь нам навести порядок в этом хаосе, имеются стандартные процессы при работе с конкретными документационно-связанными задачами. Здесь вы найдёте руководства к этим процессам.