diff options
author | Maxim Postautov <54762420+mpstv@users.noreply.github.com> | 2021-05-12 11:01:25 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-12 11:01:25 +0300 |
commit | d52eb5bd75bb115c62021cb099eff682f3598eaf (patch) | |
tree | c83f63fbf9780f3fe1af25b3d861364ef91c8dfa | |
parent | baf7f357a90db2d065b0afa00d4c7554cae3e532 (diff) | |
download | translated-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.html | 125 |
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> |