Мы открытое сообщество разработчиков, создающих ресурсы для лучшего Веба, независимо от бренда, браузера или платформы. Каждый может внести свой вклад и каждый, кто делает это, делает сильнее всех нас. Вместе мы можем продолжать стимулировать развитие инноваций в Вебе ради всеобщего блага. И это начинается здесь, с вами.
Каждая часть MDN (начиная с кода, который делает возможным работу этого сайта с документацией, и заканчивая, примерами кода и демо) создана открытым сообществом помощников и разработчиков. Присоединяйтесь к нам!
3 простых шага в MDN
MDN построена по принципу вики, где каждый может добавлять и редактировать контент. Вам не обязательно быть программистом или много знать о технологиях. Здесь много задач, которые необходимо сделать: от простых (корректура и исправление опечаток) до сложных (написание документации для API).
Сделать вклад в развитие MDN легко и безопасно. Даже если Вы допустили ошибку, её легко можно исправить. Даже если Вы не знаете точно, как что-то должно выглядеть, или Ваша грамматика недостаточно хороша, не беспокойтесь об этом! У нас есть команда людей, работа которых состоит в том, чтобы на MDN был максимально хороший контент. Кто-то будет рядом, чтобы убедиться, что Ваши работы аккуратны и хорошо написаны.
Шаг 1: Создайте аккаунт MDN
Чтобы участвовать в развитии MDN, необходимо зарегистрировать аккаунт.
Если ваши задачи включают в себя создание новых страниц, пожалуйста, посмотрите "Получение прав на создание страницы" в Как создавать и редактировать страницы для важной информации о том, как получить разрешение на добавление новых страниц; из-за соображений безопасности, у новых аккаунтов эта возможность отключена по умолчанию.
Шаг 2: Выберите задачу для выполнения
Теперь, когда у Вас есть аккаунт в MDN, прочтите описание различных типов задач в списке ниже, и решите, какая из них наиболее Вам подходит. Вы можете выбрать любую задачу, которая понравится, и начать делать вклад.
Шаг 3: Выполните задачу
Как только вы решили, какого рода задачей вы хотите заняться, найдите подходящую страницу, пример кода и так далее - и вперёд!
Не беспокойтесь о том, что можете допустить ошибки; другие участники MDN здесь, чтобы помочь исправить мелкие недочеты, которые Вы могли пропустить. Если появятся вопросы в процессе работы, загляните на страницу Сообщества для получения информации или в списки рассылок и чаты, где можно получить ответы.
Внимание: Если Вы хотите поэкспериментировать с редактированием MDN перед тем, как сделать что-то «по-настоящему», можете потренироваться на странице в Песочнице. Пожалуйста, экспериментируйте только там. Пожалуйста, не делайте ненужных изменений на обычных страницах с содержимым, только чтобы посмотреть, что случится; это добавляет работы другим.
Когда закончите, смело приступайте к следующей задаче или посмотрите чуть ниже, какие еще вещи можно сделать на MDN.
Возможные типы задач
Есть несколько направлений, которые Вы можете выбрать, чтобы внести свой вклад в развитие MDN, в зависимости от квалификации и интересов. Даже если некоторые задачи могут быть сложными, у нас есть много простых и доступных. На решение многих из этих задач уйдет не более пяти минут (а то и меньше!). Рядом с задачей и ее кратким описанием Вы найдете приблизительное время, за которое обычно решаются задачи данного типа.
Вариант 1: Мне нравятся слова
Вы можете помочь нам пересмотреть или отредактировать существующие документы, указать правильные тэги или поправить их.
- Напишите описание страницы (5-15 минут)
- Редакционная проверка (5–30 минут)
- Добавьте новую запись в словарь (15 минут - 1 час)
- Напишите статью, чтобы помочь людям узнать о Вебе (1-3 часа)
Вариант 2: Мне нравится писать код
Нам нужно больше примеров кода! Вы также можете помочь нам в разработке движка для нашей платформы, Kuma!
- Преобразование примеров кода в "живые" (30 минут)
- Настройка среды сборки Kuma (1 час)
- Отправьте ваш код патча в кодовую базу Kuma (1 час)
Вариант 3: Мне одинаково нравится писать слова и код
У нас есть задачи, которые требуют технических навыков и языковых, такие как написание новых статей, технический обзор, а также адаптация документов.
- Поставить метки JavaScript страницам (5 минут)
- Содействие MDN на вашем собственном веб-сайте (5 минут)
- Технические обзоры (30 минут)
- Напишите новую статью по теме, которая в настоящее время не освещена (1 час или больше)
- Создайте интерактивное приложение, чтобы помочь людям узнать больше о Вебе (1 час или больше)
- Исправьте баги документации из MDN категории в Bugs Ahoy (1 час или больше)
Вариант 4: Я хочу перевести MDN на свой язык
Вся работа по локализации и переводу MDN делается нашим замечательным сообществом добровольцев.
- Перевод страницы (2 часа)
- Связь с другими локализаторами, перечисленными в локализации проектов (30 минут)
Вариант 5: Я нашел ошибки, но не знаю, как их исправить
Вы можете сообщить нам о найденых ошибках. (5 минут)
Используйте следующие данные при отправке:
| Поле в трекере Bugzilla | Значение |
продукт |
Документация для разработчиков |
компонент |
[укажите область подходящую по теме, или оставьте "General" (Общие) если не нашли подходящую] |
URL |
Страница, где была найдена ошибка |
Описание |
По возможности, напишите, что Вам известно о проблеме и где найти корректную информацию. Это может быть человек или ссылки на веб-сайты с правильной информацией. |
Другие вещи, которые вы можете делать на MDN
- Присоединиться к сообществу MDN.
- Заполните ваш профиль, чтобы другие смогли узнать о вас больше.
- Узнайте больше о вкладе в MDN.