На MDN всегда существуют вещи, которые добавляются или обновляются. Будь то новая документация по новому сверкающему API или пересмотр старого, слегка изменившегося, API, вы всегда найдёте множество возможностей для помощи.
Редактирование существующей страницы
Если вы нашли страницу, которую хотели бы пересмотреть, просто нажмите на кнопку «Редактировать» в её верхнем правом углу. Это действие откроет WYSIWYG-редактор для работы над содержимым страницы. Для подробностей о том, как работать с редактором, а также с системой макросов, которую мы используем для автоматизации некоторырых конструкций форматирования содержимого, смотрите руководство по редактору MDN.
Существует множество причин, по которым вы можете захотеть отредактировать существующую страницу:
- Вы обнаружили ошибку или опечатку.
- Вы хотите изменить формулировку для её лучшего понимания.
- Компоновка или форматирование страницы ужасно.
- Задокументированный API изменился и документация нуждается в обновлении, чтобы она соотвествовала этим изменениям.
- Вы хотите добавить информацию о разнице в поведении API между браузерами.
- Вы хотите добавить или улучшить примеры кода. Для подробностей смотрите раздел добавление примера кода ниже.
- Статья является заглушкой, либо просто упускает некоторые важные детали.
Добавление новой страницы
Это очень здорово! Добавление новой страницы на MDN делает веб чуточку лучше. Есть несколько очевидных причин для создания новой страницы, включая документирование API, который ещё не был задокументирован, либо добавление нового урока или руководства по теме.
Существует несколько способов создания новой страницы на MDN, но все они доступны только когда вы вошли в систему:
- Нажатие на ссылку, ведущую на «несуществующую страницу»
- При просмотре MDN, иногда вы будете находить ссылки на ещё несуществующие страницы. Довольно часто при создании статьи мы включаем в неё ссылки на страницы, которые нужно создать, но которые мы ещё не создали. Это помогает нам следить за теми вещами, что, в конечном итоге, должны быть сделаны, хотя иногда, чтобы вернуться к ним, требуется время. Вы можете не стесняться и сами сделать это! Просто нажмите на ссылку, и вы попадёте прямо в редактор для новой страницы.
- Создание дочерней страницы
- В верхнем правом углу каждой статьи находится выпадающее меню «Эта страница». В этом меню есть пункт «Новая подстраница». Нажатие на этот пункт меню открывает редактор для новой страницы, чьим родителем в иерархии сайта будет страница, на которой вы нажали пункт меню «Новая подстраница». Просто заполните название и короткую ссылку и начните создавать содержимое страницы.
- Создание клона страницы
- Вы также можете склонировать существующую страницу, используя пункт «Клонировать эту страницу» в выпадающем меню «Эта страница». Нажатие на этот пункт создаст копию текущей страницы, чьим родителем будет та же страница, что и у текущей страницы и откроет редактор, в котором вы сможете проставить название и короткую ссылку склонированной страницы, а также отредактировать её содержимое. Как правило, это хороший способ добавления новой страницы в уже существующую область сайта, например потому, что вы получаете образец компоновки для нового содержимого.
- Создание ссылки на несуществующую страницу, затем нажатие на неё
- Это в некотором роде гибридный метод. Поскольку каждая страница должна быть связана с какой-нибудь другой, вы можете начать с создания ссылки на новую статью на уже существующей странице, а затем, после сохранения той страницы, вы можете нажать на только что созданную ссылку и открыть редактор для новой статьи.
Примечание: если вы не вошли в систему, вы получите ошибку 404 при попытке просмотреть несуществующую статью, вместо появления редактора для создания новой страницы.
Поиск информации
На сайте содержится просто огромное количество информации и поэтому может быть сложно выцепить точную необходимую вам помощь. Вот несколько подсказок, с чего можно начать.
- Списки владельцев модулей
- Проекты Mozilla работают на базе так называемых «владельцев модулей»; каждый главный компонент имеет владельца или владельцев, которые отвечают за то, что с ним происходит. Владельцы часто являются лучшим источником информации — или, по крайней мере, они помогут найти нужного человека, с которым можно поговорить.
- Перекрёстные ссылки между исходниками Mozilla
- MXR, перекрёстные ссылки проектов Mozilla, позволяет вам получить доступ к всем исходным кодам проекта Mozilla (за исключением некоторых вещей, главным образом связанных с ОС Firefox, которые находятся на GitHub). Код и комментарии в коде часто являются отличным информационным ресурсом.
- Вики Mozilla
- Вики Mozilla — часто на неё ссылаются как на «wikimo» — это хранилище замечаний по процессу и дизайну, черновиков, планов и предварительных спецификаций. Несмотря на то, что часто там сам чёрт ногу сломит, она является кладезем бесценной информации.