Как сделать вклад в Обучающую Арею на MDN

Если вы здесь впервые или после глубокого поиска, это вероятно потому, что вы хотите помочь Обучающей Зоне MDN. Это замечательные новости!

На этой странице, вы найдёте всё, что вам нужно для начала помощи улучшения обучающего контента MDN. Здесь есть много вещей, которые вы можете сделать, в зависимости от того, сколько времени у вас есть и кем вы являетесь новичком, веб-разработчиком или учителем.

Найдите специфичные задачи

Участники используют Trello board для организации их задач. Там вы можете найти конкретные задачи проекта, ожидающие выполнения. Если вы хотите использовать её, просто создайте Trello аккаунт и напишите Chris Mills, чтобы он дал доступ к записи на доску.

Принятие участия это также отличный способ повеселиться, пока обучаешься новым вещам. Если вы запутались или у вас есть вопросы, не стесняйтесь найти нас на наш список рассылки или IRC канал (смотрите внизу страницы для деталей). Chris Mills заведует Обучающей Зоной — вы можете написать ему напрямую.

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

Я новичёк

Это круто! Новички очень важны для создания и предоставления отзывов об материалах для обучения. У вас есть уникальная возможность на этих статьях, как участник их целевой аудитории, который может сделать вас бесценным участником нашей команды. В самом деле, если вы пользуетесь одной из наших статей для обучения, и вы застряли, или находите эту статью в некотором роде запутанной, вы можете исправить её или дайте нам знать об этой проблеме, поэтому мы можем быть уверены, что она будет исправлена.

Вот некоторые предложенные способы, которыми вы можете помочь:

Добавьте теги к нашим статьям (5 мин)

Tagging MDN content is one of the easiest ways to contribute to MDN. As many of our features use tags to help present information in context, helping with tagging is a very valuable contribution. Take a look at the lists of glossary entries and learning articles without any tags to get started.

Прочтите и рассмотрите глоссарий (15 мин)

As a beginner, we need your fresh eyes looking at our content. If you find a glossary entry hard to understand, it means that entry needs to be improved. Feel free to make any change you think are necessary. If you do not think you have the proper skill to edit the entry yourself, at least tell us on our mailing list.

Напишите новую запись в глоссарий (1 час)

This is the most effective way to learn something new. Pick a concept you want to understand, and as you learn about it, write a glossary entry about it. Explaining something to others is a great way to "cement" the knowledge in your brain, and to help you make sense of things yourself, all while helping other people. Everybody wins!

Прочтите и рассмотрите статью обучения (2 часа)

This is very much like reviewing glossary entries (see above); it just takes more time, since these articles are typically quite a bit longer.

Я веб-разработчик

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

Прочтите и проверьте запись словаря (5 мин)

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

Напишите новую запись в словарь (20 минут)

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

Прочтите и рассмотрите статью обучения (2 часа)

Это тоже самое, как и расмотрение записи глоссария (см.выше); Оно просто занимает больше времени потому, что статьи чуть-чуть длинее.

Напишите новую обучающую статью (4 часа или больше)

MDN не хватает простых прямых статей об использовании веб-технологий (HTML, CSS, JavaScript, и т.д). У нас также есть старый контент, который заслуживает того, чтобы быть пересмотренным и изменённым. Усильте ваши умения до предела, чтобы сделать веб-технологии пригодными для использования даже новичками.

Создайте упражнения, примеры кода или интерактивные обучающие инструменты (? часа)

All our learning articles require what we call "active learning" materials, because people learn best by doing something themselves. Such materials are exercises or interactive content that help a user to apply and manipulate the concepts detailed in an article. There are many possible ways to make active learning content, from creating code samples with JSFiddle or similar, to building fully hackable interactive content with Thimble. Unleash your creativity!

Я учитель

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

Прочтите и рассмотрите запись словаря (15 мин)

Check out a glossary entry and feel free to make any changes you think are necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.

Напишите новую запись в глоссарий (1 час)

Clear, simple definitions of terms and basic overviews of concepts in the glossary are critical in meeting beginners' needs. Your experience as an educator can help create excellent glossary entries; we have many undefined terms which need your attention. Pick one and go for it.

Добавьте илллюстрации и/или схемы в статью (1 час)

As you might know, illustrations are an invaluable part of any learning content. This is something we often lack on MDN and your skills can make a difference in that area. Check out the articles that lack illustrative content and pick one you'd like to create graphics for.

Прочтите и рассмотрите статью обучения (2 часа)

This is similar to reviewing glossary entries (see above), but it requires more time since the articles are typically quite a bit longer.

Напиши новую обучающую статью (4 часа)

Нам нужны простые, прямые статьи о Web экосистеме и других функциональных заголовках вокруг него. Эти обучающие статьи должны быть образовательными вместо того, чтобы в буквальном смысле охватывать всё что нужно знать, ваш опыт знает что нужно охватить и как будет хорошо.

Создайте упражнения, викторины или интерактивные обучающие инструменты (? часа)

All our learning articles require "active learning" materials. Such materials are exercises or interactive content which help a user learn to use and expand upon the concepts detailed in an article.  There are lots of things you can do here, from creating quizzes to building fully hackable interactive content with Thimble. Unleash your creativity!

Создайте пути обучения (? часа)

In order to provide progressive and comprehensible tutorials, we need to shape our content into pathways. It's a way to gather existing content and figure out what is missing to create a learning article to write.