MDN - быстрый старт!

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

Каждая часть MDN (начиная с кода, который делает возможным работу этого сайта с документацией, и заканчивая, примерами кода и демо) создана открытым сообществом помощников и разработчиков. Присоединяйтесь к нам!

3 простых шага в MDN

MDN построена по принципу вики, где каждый может добавлять и редактировать контент. Вам не обязательно быть программистом или много знать о технологиях. Здесь много задач, которые необходимо сделать: от простых (корректура и исправление опечаток) до сложных (написание документации для API).

Сделать вклад в развитие MDN легко и безопасно. Даже если Вы допустили ошибку, её легко можно исправить. Даже если Вы не знаете точно, как что-то должно выглядеть, или Ваша грамматика недостаточно хороша, не беспокойтесь об этом! У нас есть команда людей, работа которых состоит в том, чтобы на MDN был максимально хороший контент. Кто-то будет рядом, чтобы убедиться, что Ваши работы аккуратны и хорошо написаны.

Шаг 1: Создайте аккаунт MDN

Чтобы участвовать в развитии MDN, необходимо зарегистрировать аккаунт.

Если ваши задачи включают в себя создание новых страниц, пожалуйста, посмотрите "Получение прав на создание страницы" в Как создавать и редактировать страницы для важной информации о том, как получить разрешение на добавление новых страниц; из-за соображений безопасности, у новых аккаунтов эта возможность отключена по умолчанию.

Шаг 2: Выберите задачу для выполнения

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

Шаг 3: Выполните задачу

Как только вы решили, какого рода задачей вы хотите заняться, найдите подходящую страницу, пример кода и так далее - и вперёд!

Не беспокойтесь о том, что можете допустить ошибки; другие участники MDN здесь, чтобы помочь исправить мелкие недочеты, которые Вы могли пропустить. Если появятся вопросы в процессе работы, загляните на страницу Сообщества для получения информации или в списки рассылок и чаты, где можно получить ответы.

Внимание: Если Вы хотите поэкспериментировать с редактированием MDN перед тем, как сделать что-то «по-настоящему», можете потренироваться на странице в Песочнице. Пожалуйста, экспериментируйте только там. Пожалуйста, не делайте ненужных изменений на обычных страницах с содержимым, только чтобы посмотреть, что случится; это добавляет работы другим.

Когда закончите, смело приступайте к следующей задаче или посмотрите чуть ниже, какие еще вещи можно сделать на MDN.

Возможные типы задач

Есть несколько направлений, которые Вы можете выбрать, чтобы внести свой вклад в развитие MDN, в зависимости от квалификации и интересов. Даже если некоторые задачи могут быть сложными, у нас есть много простых и доступных. На решение многих из этих задач уйдет не более пяти минут (а то и меньше!). Рядом с задачей и ее кратким описанием Вы найдете приблизительное время, за которое обычно решаются задачи данного типа.

Вариант 1: Мне нравятся слова

Вы можете помочь нам пересмотреть или отредактировать существующие документы, указать правильные тэги или поправить их.

Примечание: Если Вы рецензируете статьи или пишете новые, мы просим ознакомиться с Инструкцией по оформлению. Это поможет статьям соответствовать правилам MDN.

Вариант 2: Мне нравится писать код

Нам нужно больше примеров кода! Вы также можете помочь нам в разработке движка для нашей платформы, Kuma!

Вариант 3: Мне одинаково нравится писать слова и код

У нас есть задачи, которые требуют технических навыков и языковых, такие как написание новых статей, технический обзор, а также адаптация документов.

Вариант 4: Я хочу перевести MDN на свой язык

Вся работа по локализации и переводу MDN делается нашим замечательным сообществом добровольцев.

Вариант 5: Я нашел ошибки, но не знаю, как их исправить

Вы можете сообщить нам о найденых ошибках. (5 минут)

Используйте следующие данные при отправке:

Поле в трекере Bugzilla Значение
продукт Документация для разработчиков
компонент [укажите область подходящую по теме, или оставьте "General" (Общие) если не нашли подходящую]
URL Страница, где была найдена ошибка
Описание По возможности, напишите, что Вам известно о проблеме и где найти корректную информацию. Это может быть человек или ссылки на веб-сайты с правильной информацией.

Другие вещи, которые вы можете делать на MDN

Метки документа и участники

 Внесли вклад в эту страницу: BychekRU, acidicMercury8, vvscode, klimovakristina, vokaluk666, uchayev, Rale, briliantovoe, Aleksej, Treder, ilya, Vovan
 Обновлялась последний раз: BychekRU,