aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMaxim Postautov <54762420+mpstv@users.noreply.github.com>2021-05-12 11:01:25 +0300
committerGitHub <noreply@github.com>2021-05-12 11:01:25 +0300
commitd52eb5bd75bb115c62021cb099eff682f3598eaf (patch)
treec83f63fbf9780f3fe1af25b3d861364ef91c8dfa
parentbaf7f357a90db2d065b0afa00d4c7554cae3e532 (diff)
downloadtranslated-content-d52eb5bd75bb115c62021cb099eff682f3598eaf.tar.gz
translated-content-d52eb5bd75bb115c62021cb099eff682f3598eaf.tar.bz2
translated-content-d52eb5bd75bb115c62021cb099eff682f3598eaf.zip
Update translation "Getting Started on MDN" page (#758)
Co-authored-by: Artem Shibakov <shibakow@gmail.com>
-rw-r--r--files/ru/mdn/contribute/getting_started/index.html125
1 files changed, 27 insertions, 98 deletions
diff --git a/files/ru/mdn/contribute/getting_started/index.html b/files/ru/mdn/contribute/getting_started/index.html
index 653a62a472..3ca165c3b1 100644
--- a/files/ru/mdn/contribute/getting_started/index.html
+++ b/files/ru/mdn/contribute/getting_started/index.html
@@ -2,128 +2,57 @@
title: Mozilla - Быстрый старт!
slug: MDN/Contribute/Getting_started
translation_of: MDN/Contribute/Getting_started
+tags:
+ - Документация
+ - Начало работы
+ - Гайд
+ - MDN
+ - MDN Project
+ - Новые участники
---
<div>{{MDNSidebar}}</div>
-<div>{{IncludeSubnav("/ru/docs/MDN")}}</div>
+<p id="What_is_MDN.3F"><span class="seoSummary"></span><p>Мы — открытое сообщество разработчиков, которые создают ресурсы для лучшего Веба, не зависящего от брендов, браузеров или платформ. В этом деле нам может помочь любой желающий, делая сильнее всё наше сообщество. Вместе мы будем развивать инновации в Вебе для всеобщего блага. Это начинается прямо здесь, вместе с вами.</span></p>
-<p>Мы – открытое сообщество разработчиков, которые создают ресурсы для лучшего Веба, не зависящего от брендов, браузеров или платформ. В этом деле нам может помочь любой желающий, делая сильнее всё наше сообщество. Вместе мы будем развивать инновации в Вебе для всеобщего блага. Это начинается прямо здесь, вместе с вами.</p>
+<p>Каждая часть MDN (документация, демо и сам сайт целиком) создана открытым сообществом разработчиков. Пожалуйста, присоединяйтесь к нам!</p>
-<p><span>Каждая часть MDN (документация, демки и сам сайт целиком) создана открытым сообществом разработчиков. Присоединяйтесь к нам!</span></p>
+<h2 id="4_простых_шага_в_MDN"><span>4 простых шага в MDN</span></h2>
-<h2 id="3_простых_шага_в_MDN"><span>3 простых шага в MDN</span></h2>
-
-<p><span class="seoSummary">MDN построена по принципу вики, где <strong>каждый</strong> может добавлять и редактировать контент. Вам не обязательно быть программистом или много знать о технологиях. Здесь много задач, которые необходимо сделать: от простых (<span>корректура</span> <span>и</span> <span>исправление опечаток</span>) до сложных (написание документации для API).</span></p>
+<p>MDN — это ресурс с открытым исходным кодом, где <strong>каждый</strong> может добавлять и редактировать контент. Вам не обязательно быть программистом или хорошо разбираться в технологиях, чтобы внести свой вклад - здесь найдется множество различных задач, от простых (вычитка и исправление опечаток) до сложных (написание документации по API).</p>
<p>Сделать вклад в развитие MDN легко и безопасно. Даже если вы допустили ошибку, её легко можно исправить. Даже если вы не знаете точно, как что-то должно выглядеть, или ваша грамматика недостаточно хороша, не беспокойтесь об этом! У нас есть команда людей, работа которых состоит в том, чтобы на MDN был максимально хороший контент. Кто-нибудь обязательно проверит, насколько ваши работы аккуратно и хорошо написаны. Делитесь тем, что вы знаете и верьте в свои силы.</p>
-<h3 id="Шаг_1_Создайте_аккаунт_MDN">Шаг 1: Создайте аккаунт MDN</h3>
-
-<p>Чтобы участвовать в развитии MDN, необходимо<a href="/ru/docs/MDN/Contribute/Howto/Create_an_MDN_account"> зарегистрировать аккаунт</a>.</p>
+<h3>Шаг 1: Создайте аккаунт GitHub</h3>
-<p>Если ваши задачи включают в себя создание новых страниц, пожалуйста, посмотрите {{SectionOnPage("/ru/docs/MDN/Contribute/Creating_and_editing_pages", "Получение прав на создание страницы")}}, это информация о том, как получить разрешение на добавление новых страниц. Из соображений безопасности, у новых аккаунтов эта возможность по умолчанию отключена.</p>
+<p>Чтобы начать учавствовать в развитии MDN, вам необходимо <a href="https://github.com/mdn/content/#setup">создать учётную запись GitHub</a>.</p>
<h3 id="Шаг_2_Выберите_задачу_для_выполнения">Шаг 2: Выберите задачу для выполнения</h3>
-<p>Теперь, когда у вас есть аккаунт в MDN, прочтите описание различных типов задач в {{anch("Возможные типы задач", "списке ниже")}}, и решите, какая из них наиболее вам подходит. Вы можете начать выполнять любую понравившуюся задачу.</p>
+<p>Теперь, когда вы вошли в систему, изучите список различных типов задач на <a href="/ru/docs/MDN/Contribute">основной странице</a>. Вы можете взять в работу любую понравившуюся задачу и начать помогать MDN.</p>
<h3 id="Шаг_3_Выполните_задачу">Шаг 3: Выполните задачу</h3>
-<p>Как только вы решили, какого рода задачей вы хотите заняться, найдите подходящую страницу, пример кода и т.д. - и вперёд!</p>
-
-<p>Не беспокойтесь о том, что можете допустить ошибки. Другие участники MDN здесь, чтобы помочь исправить мелкие недочёты, которые вы могли пропустить. Если появятся вопросы в процессе работы, загляните на страницу <a href="/ru/docs/MDN/Community">Сообщества</a> для получения информации или в списки рассылок и чаты, где можно получить ответы.</p>
-
-<div class="note">
-<p><strong>Внимание: </strong>Если вы хотите поэкспериментировать с редактированием MDN перед тем, как сделать что-то «по-настоящему», можете потренироваться на странице в <strong><a href="/ru/docs/Sandbox">Песочнице</a></strong>. Пожалуйста, экспериментируйте только там. Не делайте ненужных изменений на обычных страницах, только чтобы посмотреть, что получится. Это добавляет работы другим.</p>
-</div>
-
-<p>Когда закончите, смело приступайте к следующей задаче или посмотрите чуть ниже, <a href="#Другие_вещи_которые_вы_можете_делать_на_MDN">какие ещё вещи можно сделать на MDN</a>.</p>
-
-<h2 id="Возможные_типы_задач">Возможные типы задач</h2>
+<p>Как только вы решили, какого рода задачей вы хотите заняться, найдите конкретную страницу, пример кода и т.д. - и вперёд!</p>
-<p>Есть несколько направлений, которые вы можете выбрать, чтобы внести свой вклад в развитие MDN, в зависимости от квалификации и интересов. Даже если некоторые задачи покажутся сложными, у нас есть много других, простых и доступных. На решение большинства из них уйдёт не более пяти минут (а то и меньше!). Рядом с задачей и её кратким описанием вы найдёте приблизительное время, за которое обычно решаются задачи данного типа.</p>
+<h3 id="Шаг_4_обратитесь_за_помощью">Шаг 4: Обратитесь за помощью</h3>
-<h3 id="Вариант_1_Мне_нравятся_слова">Вариант 1: Мне нравятся слова</h3>
-
-<p>Вы можете помочь нам проверить или отредактировать существующие документы, указать правильные тэги или поправить их.</p>
+<p>Если в какой-то момент вы столкнулись с проблемой, то приветствуется обратиться за помощью. Для этого есть несколько вариантов:</p>
<ul>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Как_оптимизировать_страницы"><font><font>Напишите описание страницы</font></font></a><font><font> (5-15 минут)</font></font></li>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Do_an_editorial_review">Редакционная проверка</a> (5–30 минут)</li>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary"><font><font>Добавьте новую запись в словарь</font></font></a><font><font> (15 минут - 1 час)</font></font></li>
- <li><font><font><a href="https://developer.mozilla.org/ru/docs/Project:MDN/Contributing/How_to/Write_an_article_to_help_learning_the_web">Напишите статью, чтобы помочь людям узнать о Вебе</a></font></font><font><font> (1-3 часа)</font></font></li>
+ <li>Если вы хотите поговорить с нами синхронно и задавать вопросы о самом MDN, присоединяйтесь к обсуждению в <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">чате MDN Web Docs</a> с помощью <a href="https://wiki.mozilla.org/Matrix">Matrix</a>.</li>
+ <li>Вы также можете отправить нам письмо на адрес <a href="mailto:mdn-admins@mozilla.org">mdn-admins@mozilla.org</a>.</li>
+ <li>Если вы изучаете веб-разработку и столкнулись с проблемой программирования, у нас есть <a href="https://discourse.mozilla.org/c/mdn/learn/250">активные форумы</a>, где вы можете задать вопросы и получить помощь.</li>
</ul>
-<div class="note"><strong>Примечание:</strong> Если вы рецензируете статьи или пишете новые, мы просим ознакомиться с <a href="/ru/docs/Project:Writer's_guide">Инструкцией по оформлению</a>. Это поможет статьям соответствовать правилам MDN.</div>
-
-<h3 id="Вариант_2_Мне_нравится_писать_код">Вариант 2: Мне нравится писать код</h3>
-
-<p>Нам нужно больше примеров кода! Вы также можете помочь нам в разработке движка для нашей платформы <a href="/ru/docs/MDN/Kuma">Kuma</a>!</p>
+<p>Не беспокойтесь о том, чтобы сделать все идеально: другие участники MDN готовы помочь исправить возникающие ошибки.</p>
-<ul>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Convert_code_samples_to_be_live"><font><font>Преобразование примеров кода в "живые"</font></font></a><font><font> (30 минут)</font></font></li>
- <li><a href="https://kuma.readthedocs.org/en/latest/installation-vagrant.html"><font><font>Настройка среды сборки Kuma</font></font></a><font><font> (1 час)</font></font></li>
- <li><a href="https://github.com/mozilla/kuma#readme"><font><font>Отправьте ваш патч кода в кодовую базу Kuma</font></font></a><font><font> (1 час)</font></font></li>
- <li><a href="https://developer.mozilla.org/en-US/docs/Web/Demos_of_open_web_technologies"><font><font>Добавьте новую демку</font></font></a> (1 час)</li>
-</ul>
-
-<h3 id="Вариант_3_Мне_одинаково_нравится_писать_слова_и_код">Вариант 3: Мне одинаково нравится писать слова и код</h3>
-
-<p>У нас есть задачи, которые требуют технических навыков и языковых, такие как написание новых статей, технический обзор, а также адаптация документов.</p>
-
-<ul>
- <li><font><font><a href="/ru/docs/MDN/Contribute/Howto/Метки_JavaScript_страниц">Отметьте страницы с JavaScript</a> (5 минут)</font></font></li>
- <li><font><font><a href="/ru/docs/MDN/Promote">Продвигайте MDN на вашем собственном веб-сайте</a></font></font><font><font> (5 минут)</font></font></li>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Do_a_technical_review">Техническая проверка</a> (30 минут)</li>
- <li><a href="/ru/docs/Contribute_to_docs_that_are_currently_needed">Напишите новую статью по теме, которая в настоящее время не освещена</a> (1 час или больше)</li>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Создай_интерактивное_упражнение_для_помощи_в_изучении_веба">Создайте интерактивное приложение, чтобы помочь людям узнать больше о Вебе</a> (1 час или больше)</li>
- <li><a href="/ru/docs/MDN/Contribute/Howto/Resolve_a_mentored_developer_doc_request">Исправьте баги документации</a> из <a href="http://www.joshmatthews.net/bugsahoy/?mdn=1">MDN категории в Bugs Ahoy</a> (1 час или больше)</li>
-</ul>
-
-<h3 id="Вариант_4_Я_хочу_перевести_MDN_на_свой_язык">Вариант 4: Я хочу перевести MDN на свой язык</h3>
-
-<p>Вся работа по локализации и переводу MDN делается нашим замечательным сообществом добровольцев.</p>
-
-<ul>
- <li><a href="/ru/docs/Project:MDN/Localizing/Translating_pages"><font><font>Перевод страницы</font></font></a><font><font> (2 часа)</font></font></li>
- <li><font><font>Связь с другими локализаторами, перечисленными в </font></font><a href="/ru/docs/Project:MDN/Localizing/Localization_projects"><font><font>локализации проектов</font></font></a><font><font> (30 минут)</font></font></li>
-</ul>
+<h2 id="Полезные_руководства_для_начинающих">Полезные руководства для начинающих</h2>
-<h3 id="Вариант_5_Я_нашёл_ошибки_но_не_знаю_как_их_исправить">Вариант 5: Я нашёл ошибки, но не знаю, как их исправить</h3>
-
-<p>Вы можете сообщить <a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">нам о найденных ошибках</a>. (5 минут)</p>
-
-<p>Используйте следующие данные при отправке:</p>
-
-<table class="standard-table">
- <tbody>
- <tr>
- <td><strong>Поле в трекере Bugzilla</strong></td>
- <td><strong>Значение</strong></td>
- </tr>
- <tr>
- <td><code><font><font>продукт</font></font></code></td>
- <td><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Developer+Documentation">Документация для разработчиков</a></td>
- </tr>
- <tr>
- <td><code><font><font>компонент</font></font></code></td>
- <td>[укажите область подходящую по теме, или оставьте "General" (Общие) если не нашли подходящую]</td>
- </tr>
- <tr>
- <td><code><font><font>URL</font></font></code></td>
- <td>Страница, где была найдена ошибка</td>
- </tr>
- <tr>
- <td><code><font><font>Описание</font></font></code></td>
- <td><span id="result_box" lang="ru"><span class="hps">По возможности, напишите, что вам известно о проблеме</span> <span class="hps">и</span> <span class="hps">где найти</span> корректную<span class="hps"> информацию</span><span>.</span> <span class="hps">Это может</span> быть человек или <span class="hps">ссылки</span><span> на веб-сайты с правильной информацией.</span></span></td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Другие_вещи_которые_вы_можете_делать_на_MDN">Другие вещи, которые вы можете делать на MDN</h2>
+<p>Мы ожидаем, что участники MDN будут обладать определенным багажом знаний прежде, чем они начнут работать над контентом. Если вы новичок в приведенных темах, мы советуем посмотреть следующие ссылки, которые помогут вам в изучении:</p>
<ul>
- <li><a href="/ru/docs/MDN/Сообщество">Присоединиться к сообществу MDN</a>.</li>
- <li><a href="/ru/profile">Заполните профиль</a>, чтобы другие смогли лучше узнать Вас.</li>
- <li>Узнайте больше о <a href="/ru/docs/MDN/Contribute">вкладе в MDN</a>.</li>
+ <li>Веб-технологии: если вы новичок в HTML, CSS, JavaScript, и т.д., посмотрите наши руководства: <a href="/ru/docs/Learn">Изучение веб-разработки</a></li>
+ <li>Открытый код: если вы пока не учавствовали в проектах с открытым исходным кодом, прочтите <a href="/en-US/docs/MDN/Contribute/Open_source_etiquette">основы этикета для проектов с открытым исходным кодом (EN)</a>.</li>
+ <li>Git и GitHub: если вы не знакомы с этими инструментами, <a href="/en-US/docs/MDN/Contribute/GitHub_beginners">GitHub для начинающих (EN)</a> поможет вам изучить основы.</li>
+ <li>Структура репозитория MDN: если вы не уверены, какие репозитории редактировать, для внесения изменений в различные части контента MDN, <a href="/en-US/docs/MDN/Contribute/Where_is_everything">где всё на MDN? (EN)</a> укажет правильные места.</li>
</ul>