Мы – открытое сообщество разработчиков, которые создают ресурсы для лучшего Веба, не зависящего от брендов, браузеров или платформ. В этом деле нам может помочь любой желающий, делая сильнее всё наше сообщество. Вместе мы будем развивать инновации в Вебе для всеобщего блага. Это начинается прямо здесь, вместе с вами.
Каждая часть 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 час)
- Добавьте новую демку (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.