initial commit

7 files changed, 524 insertions, 0 deletions

diff --git a/files/ru/mdn/user_guide/advanced_search/index.html b/files/ru/mdn/user_guide/advanced_search/index.html
new file mode 100644
index 0000000000..08ba78607f
--- /dev/null
+++ b/files/ru/mdn/user_guide/advanced_search/index.html
@@ -0,0 +1,104 @@
+---
+title: Использование продвинутого поиска
+slug: MDN/User_guide/Advanced_search
+tags:
+  - Guide
+  - MDN
+translation_of: MDN/Tools/Search
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary">В качестве дополнительной возможности внесения для вкладчиков в MDN у нас есть продвинутый механизм поиска, который позволяется вам искать по исходному коду страницы — то есть, по сырому HTML сайта, с макросами вместо их вывода — что позволяет искать использования определённых макросов, атрибутов HTML и тому подобное.</span></p>
+<p>На текущий момент для использования продвинутого механизма поиска нет пользовательского интерфейса, но вы можете получить к нему доступ посредством специально сформированных URL. Вы можете получить вывод либо на стандартную страницу с результатами поиска по MDN, либо в формате JSON (последнее означает, что вы можете использовать этот механизм, например, из кода на KumaScript). <span class="seoSummary">Эта статья описывает, как всем этим пользоваться.</span></p>
+<div class="note">
+ <p><strong>Примечание:</strong> эти поисковые запросы не предназначены для конструирования распространяемых URL; а предназначены для использования во вспомогательных инструментах и утилитах. В будущем они могут измениться, также не обязательно, что эти запросы самые эффективные.</p>
+</div>
+
+<h2 id="Search_query_format" name="Search_query_format">Формат поискового запроса</h2>
+<p>Продвинутые поисковые запросы позволяются конструировать URL с соответствующими параметрами. Базовый URL может быть одним из следующих:</p>
+<dl>
+ <dt><code>https://developer.mozilla.org/en-US/search</code></dt>
+ <dd>Используйте этот базовый URL для получения стандартной страницы с результатами поиска по MDN.</dd>
+ <dt><code>https://developer.mozilla.org/en-US/search.json</code></dt>
+ <dd>Используйте этот базовый URL для получения результатов в формате JSON. О формате результата смотрите раздел {{anch("JSON_result_format", "формат JSON для результата")}}.</dd>
+</dl>
+<p>Кроме того, вам нужно добавить соответствующие параметры для получения желаемого результата. Вы можете использовать любую комбинацию следующих параметров:</p>
+<dl>
+ <dt><code>locale=</code></dt>
+ <dd>Рассматриваемая локаль. По умолчанию рассматриваются все локали. Также вы можете явно указать «все локали» при помощи шаблона <code>"*"</code>. Например, вы можете определить <code>locale=en-US</code> для ограничения поиска только по англоязычным страницам.</dd>
+ <dt><code>css_classnames=</code></dt>
+ <dd>Классы CSS для сопоставления. Этот параметр ограничивает результат поиска страницами, чей HTML-код включает в сеся как минимум одно использование указанных классов.</dd>
+ <dt><code>html_attributes=</code></dt>
+ <dd>Текст атрибутов HTML для сопоставления. Поиск ведётся по началу текста; то есть, если указаный текст появляется в начале строки атрибута HTML, он будет считаться совпавшим. Подробности смотрите ниже.</dd>
+ <dt><code>kumascript_macros=</code></dt>
+ <dd>Список искомых макросов KumaScript. Этот параметр позволяет вам находить статьи, использующие определённый макрос; это может быть полезно в тех случаях, если, к примеру, макрос устарел или его параметры поменялись и вам нужно обновить существующие варианты его использования.</dd>
+</dl>
+
+<h2 id="Examples" name="Examples">Примеры</h2>
+<p>Здесь приведено несколько примеров поисковых запросов.</p>
+
+<h3 id="Searching_by_locale" name="Searching_by_locale">Поиск по локали</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US</pre>
+<p>В этом примере возвращается список всех англоязычных статей без каких-либо иных ограничений. На момент написания этой статьи их было 12865 (к тому времени, как вы прочитаете эту статью, их, конечно же, станет больше, поскольку мы постоянно растём)!</p>
+
+<h3 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">Поиск по имени CSS-класса</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;css_classnames=smaller</pre>
+<p>В этом примере мы добавили к поисковому условию использование CSS-класса <code>"smaller"</code>; на момент написания этой статьи количество результатов снизилось всего до 6 страниц.</p>
+
+<h3 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">Поиск по строке атрибута HTML</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;html_attributes=style</pre>
+<p>Здесь мы ищем использования атрибута <code>"style"</code> на элементах HTML. На момент написания этой статьи мы нашли 4935 таких страниц. Это плохо и это нужно искоренять; мы собираемся заменить все такие вхождения на наши стандартные классы.</p>
+<p>Также вы можете включать в поисковый запрос значение атрибута, но помните, что если вы захотите включить символы вроде <code>"="</code> или <code>"/"</code> в ваш поисковый запрос, вы должны их закодировать для использования в URL. Например, чтобы найти страницы, ссылающиеся на www.mozilla.org, вы можете сделать так:</p>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;html_attributes=href%3D%22https%3A%2F%2Fwww.mozilla.org</pre>
+<p>Этот поиск вернул 29 результатов. Это удивительно малое количество ссылок на сайт www.mozilla.org!</p>
+
+<h3 id="Searching_for_KumaScript_macro_usage" name="Searching_for_KumaScript_macro_usage">Поиск по используемому макросу KumaScript</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;kumascript_macros=unimplemented_header</pre>
+<p>Этот поисковый запрос ищет использования макроса {{TemplateLink("unimplemented_header")}}. На момент написания этой статьи было найдено шесть страниц. Он позволяет нам искать макросы, чьи параметры были изменены, либо те, которые мы хотим прекратить использовать (последний случай как раз относится к рассматриваемому макросу).</p>
+
+<h2 id="JSON_result_format" name="JSON_result_format">Формат JSON для результата</h2>
+<p>Когда вы запрашиваете результат в формате JSON, вы по прежнему получаете результаты по одной странице за раз. Каждая страница является объектом KumaScript, который состоит из нескольких частей с метаданными о результатах, плюс массив стандартных объектов страницы с одним дополнительным полем: URL-адресом для начала редактирования страницы.</p>
+<p>В результирующем объекте содержатся следующие данные:</p>
+<dl>
+ <dt><code>count</code></dt>
+ <dd>Общее количество найденных результатов.</dd>
+ <dt><code>next</code></dt>
+ <dd>URL, по которому можно перейти на следующую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для последней страницы).</dd>
+ <dt><code>previous</code></dt>
+ <dd>URL, по которому можно перейти на предыдущую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для первой страницы).</dd>
+ <dt><code>query</code></dt>
+ <dd>???</dd>
+ <dt><code>page</code></dt>
+ <dd>Номер страницы с результатами, описываемой этим объектом.</dd>
+ <dt><code>pages</code></dt>
+ <dd>Общее количество страниц с результатами.</dd>
+ <dt><code>start</code></dt>
+ <dd>Номер первого элемента на этой странице с результатами.</dd>
+ <dt><code>end</code></dt>
+ <dd>Номер последнего элемента на этой странице с результатами.</dd>
+ <dt><code>filters</code></dt>
+ <dd>Массив конфигураций расличных поисковых фильтров. Эти фильтры доступны в стандартном поиске.</dd>
+ <dt><code>documents</code></dt>
+ <dd>Массив {{anch("Page_objects", "объектов страницы")}}, описывающих каждую совпавшую страницу.</dd>
+</dl>
+
+<h3 id="Page_objects" name="Page_objects">Объекты страницы</h3>
+<p>Каждый объект страницы содержит следующие поля:</p>
+<dl>
+ <dt><code>title</code></dt>
+ <dd>Заголовок статьи.</dd>
+ <dt><code>slug</code></dt>
+ <dd>Идентификатор статьи. Это вся часть URL страницы, следующая за локалью и последующим символом слеша.</dd>
+ <dt><code>locale</code></dt>
+ <dd>Локаль страницы.</dd>
+ <dt><code>excerpt</code></dt>
+ <dd>Фрагмент содержания страницы; это либо первый блок обычного текста статьи, либо содержимое, отмеченное классом "SEO Summary".</dd>
+ <dt><code>url</code></dt>
+ <dd>Полный URL страницы.</dd>
+ <dt><code>edit_url</code></dt>
+ <dd>Полный URL страницы в режиме редактирования.</dd>
+ <dt><code>tags</code></dt>
+ <dd>Массив меток страницы.</dd>
+ <dt><code>score</code></dt>
+ <dd>Значение очков, присвоенное странице поисковым движком.</dd>
+ <dt><code>explanation</code></dt>
+ <dd>Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.</dd>
+</dl>
diff --git a/files/ru/mdn/user_guide/deleting_pages/index.html b/files/ru/mdn/user_guide/deleting_pages/index.html
new file mode 100644
index 0000000000..ffd7d04664
--- /dev/null
+++ b/files/ru/mdn/user_guide/deleting_pages/index.html
@@ -0,0 +1,16 @@
+---
+title: Удаление страниц
+slug: MDN/User_guide/Deleting_pages
+tags:
+  - Guide
+  - MDN
+translation_of: MDN/Tools/Page_deletion
+---
+<div>{{MDNSidebar}}</div><p>Только администраторы MDN имеют право и могут удалять страницы. <span class="seoSummary">Эта статья описывает, как отправить запрос на удаление страницы с MDN.</span></p>
+<p>Чтобы организовать удаление страницы, вы должны сделать следующее:</p>
+<ol>
+ <li><strong>Не очищайте и не изменяйте содержимое страницы.</strong> Мы хотим видеть эту страницу во время удаления.</li>
+ <li>Добавьте метку «junk» к странице. Не удаляйте другие метки.</li>
+ <li>Если страница особенно срочно нуждается в удалении (например, её содержимое неуместно, оскорбительно или технически опасно), <a href="mailto:mdn-admins@mozilla.org" title="Уведомить администратора">уведомите администратора MDN</a>.</li>
+</ol>
+<p>Администратор удалит страницу, когда это будет возможно, после того как убедится, что это удаление целесообразно.</p>
diff --git a/files/ru/mdn/user_guide/feeds/index.html b/files/ru/mdn/user_guide/feeds/index.html
new file mode 100644
index 0000000000..ba43bf1809
--- /dev/null
+++ b/files/ru/mdn/user_guide/feeds/index.html
@@ -0,0 +1,73 @@
+---
+title: Ленты новостей MDN
+slug: MDN/User_guide/Feeds
+tags:
+  - Kuma
+translation_of: MDN/Tools/Feeds
+---
+<div>{{MDNSidebar}}</div><p>Вики MDN предлагает ряд лент новостей, которые вы можете использовать для слежения за сайтом. В будущем их, вероятно, будет больше, а некоторые из них до сих пор ещё в разработке, но эта информация всё равно может быть для вас полезна.</p>
+
+<h2 id="Accessing_the_feeds" name="Accessing_the_feeds">Получение доступа к лентам новостей</h2>
+<p>Все ленты новостей начинаются со следующего базового URL:</p>
+<pre>https://developer.mozilla.org/<em>&lt;локаль&gt;</em>/docs/feeds/<em>&lt;формат&gt;</em>/</pre>
+<p>Заполнители в базовом URL могут быть заменены следующими значениями:</p>
+<ul>
+ <li><code>&lt;локаль&gt;</code> — это одна из стандартных строк локалей, например, "en-US", "ja" и так далее. В ленту новостей включаются записи только для статей в указанной локали, если вы не добавите в URL параметр <code>?all_locales</code>.</li>
+ <li><code>&lt;формат&gt;</code> — это одна из строк <code>rss</code>, <code>atom</code> или <code>json</code></li>
+</ul>
+<p>Если вы используете формат <code>json</code>, вы также можете определить дополнительный параметр запроса <code>?callback=<em>&lt;имя функции обратного вызова&gt;</em></code>, который следует <a href="https://ru.wikipedia.org/wiki/JSONP">соглашению JSONP</a> для загрузки данных как JavaScript.</p>
+
+<h2 id="Available_feeds" name="Available_feeds">Доступные ленты</h2>
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th>Лента</th>
+   <th>Описание</th>
+  </tr>
+  <tr>
+   <td><code>all</code></td>
+   <td>
+    <p>Все недавно изменённые статьи, упорядоченные по дате изменения. Также она включает в себя новые статьи. Все изменения объединяются в одну запись в ленте новостей для каждой статьи. Например:</p>
+    <p><a href="/ru/docs/feeds/rss/all">https://developer.mozilla.org/ru/docs/feeds/rss/all</a></p>
+   </td>
+  </tr>
+  <tr>
+   <td><code>revisions</code></td>
+   <td>
+    <p>Все ревизии статей, упорядоченные по дате изменения, включая новые статьи. Каждая ревизия занимает отдельную запись в ленте. Например:</p>
+    <p><a href="/ru/docs/feeds/atom/revisions">https://developer.mozilla.org/ru/docs/feeds/atom/revisions</a></p>
+   </td>
+  </tr>
+  <tr>
+   <td><code>tag/<em>&lt;имя-метки&gt;</em></code></td>
+   <td>
+    <p>Недавно изменённые статьи, упорядоченные по дате изменения. В ленту включаются только статьи с определённой меткой. Например:</p>
+    <p><a href="/ru/docs/feeds/json/tag/CSS?callback=loadFeed">https://developer.mozilla.org/ru/docs/feeds/json/tag/CSS?callback=loadFeed</a></p>
+   </td>
+  </tr>
+  <tr>
+   <td><code>files</code></td>
+   <td>
+    <p>Недавно изменённые или загруженные файлы. Например:</p>
+    <p><a href="/ru/docs/feeds/atom/files">https://developer.mozilla.org/ru/docs/feeds/atom/files</a></p>
+   </td>
+  </tr>
+  <tr>
+   <td><code>l10n-updates</code></td>
+   <td>
+    <p>Переводные статьи, чей оригинал был изменён с последнего редактирования этой статьи. Например:</p>
+    <p><a href="/ru/docs/feeds/atom/l10n-updates">https://developer.mozilla.org/ru/docs/feeds/atom/l10n-updates</a></p>
+   </td>
+  </tr>
+  <tr>
+   <td><nobr><code>needs-review[/<em>&lt;тип-проверки&gt;</em>]</code></nobr></td>
+   <td>
+    <p>Список статей, требующих определённой проверки, либо статьи, требующие любой проверки, если тип проверки не указан. Тип проверки может быть одним из <code>technical</code>, <code>editorial</code> или <code>kumascript</code>.</p>
+    <p><a href="/ru/docs/feeds/json/needs-review">https://developer.mozilla.org/ru/docs/feeds/json/needs-review</a></p>
+    <p><a href="/ru/docs/feeds/rss/needs-review/technical">https://developer.mozilla.org/ru/docs/feeds/rss/needs-review/technical</a></p>
+    <p><a href="/ru/docs/feeds/atom/needs-review/editorial">https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/editorial</a></p>
+    <p><a href="/ru/docs/feeds/atom/needs-review/kumascript">https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/kumascript</a></p>
+   </td>
+  </tr>
+ </tbody>
+</table>
diff --git a/files/ru/mdn/user_guide/index.html b/files/ru/mdn/user_guide/index.html
new file mode 100644
index 0000000000..c8999eeb85
--- /dev/null
+++ b/files/ru/mdn/user_guide/index.html
@@ -0,0 +1,12 @@
+---
+title: Руководство пользователя MDN
+slug: MDN/User_guide
+tags:
+  - Documentation
+  - Landing
+  - MDN
+translation_of: MDN/Tools
+---
+<div>{{MDNSidebar}}</div><p>Сайт сети разработчиков Mozilla является продвинутой системой для поиска, чтения и внесения документации и примеров исходного кода для веб-разработчиков (а также для разработчиков под браузер Firefox и ОС Firefox). Руководство пользователя MDN предоставляет статьи, в подробностях описывающие, как использовать MDN для поиска нужной вам документации и, если вы желаете, как помочь сделать материалы лучше: более полными и обширными.</p>
+<div>
+ {{LandingPageListSubpages}}</div>
diff --git a/files/ru/mdn/user_guide/linking_to_mdn/index.html b/files/ru/mdn/user_guide/linking_to_mdn/index.html
new file mode 100644
index 0000000000..093ce13265
--- /dev/null
+++ b/files/ru/mdn/user_guide/linking_to_mdn/index.html
@@ -0,0 +1,63 @@
+---
+title: Проставление ссылок на MDN
+slug: MDN/User_guide/Linking_to_MDN
+tags:
+  - Documentation
+  - Guide
+  - MDN
+translation_of: MDN/About/Linking_to_MDN
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary">Мы регулярно получаем от пользователей вопросы о том, как сослаться на MDN, или даже разрешено ли это делать. Краткий ответ таков: <strong>да, вы можете ссылаться на MDN!</strong> Читайте дальше, чтобы узнать о руководящих принципах и лучших практиках!</span></p>
+
+<h2 id="Can_I_link_to_MDN.3F" name="Can_I_link_to_MDN.3F">Могу ли я ссылаться на MDN?</h2>
+<p><strong>Да!</strong> Разумеется! Дело не только в том, что гипертекст — это сущность веба, это так же способ указать вашим пользователям на ценные ресурсы и показать своё доверие к работе нашего сообщества.</p>
+<p>Так что, да, мы определённо рекомендуем вам ссылаться на содержимое MDN. Не стесняетесь: ссылайтесь на <a href="/">главную страницу MDN</a>, или, ещё лучше, сразу на конкретную страницу MDN, в случае необходимости. Смотрите ниже лучшие практики определения того, на какую страницу ссылаться.</p>
+
+<h2 id="What_page_should_I_link_to.3F" name="What_page_should_I_link_to.3F">На какую страницу мне надо ссылаться?</h2>
+<p>Не существует специальной страницы, на которую вы должны ссылаться. Важно то, <strong>насколько релевантна страница для <em>ваших</em> читателей</strong>.</p>
+<ul>
+ <li>Если вы пишете в общем об MDN, вы можете ссылаться на главную страницу, <a href="/">https://developer.mozilla.org/</a>.</li>
+ <li>Если вы пишете в общем о какой-то конкретной теме, вы можете ссылаться на <strong>целевые страницы</strong>, то есть, специальные страницы, которые служат в качестве оглавления или индекса по этой теме. Несколько общих целевых страниц:
+  <ul>
+   <li>HTML: <a href="/ru/docs/Web/HTML">https://developer.mozilla.org/ru/docs/Web/HTML</a></li>
+   <li>HTML5: <a href="/ru/docs/Web/Guide/HTML/HTML5">https://developer.mozilla.org/ru/docs/Web/Guide/HTML/HTML5</a></li>
+   <li>CSS: <a href="/ru/docs/Web/CSS">https://developer.mozilla.org/ru/docs/Web/CSS</a></li>
+   <li>CSS3: <a href="/ru/docs/Web/CSS/CSS3">https://developer.mozilla.org/ru/docs/Web/CSS/CSS3</a></li>
+   <li>DOM: <a href="/ru/docs/Web/API/Document_Object_Model">https://developer.mozilla.org/ru/docs/Web/API/Document_Object_Model</a></li>
+   <li>JavaScript: <a href="/ru/docs/Web/JavaScript">https://developer.mozilla.org/ru/docs/Web/JavaScript</a></li>
+  </ul>
+ </li>
+ <li>Если вы пишете о конкретной странице, элементе, методе и так далее, вы можете ссылаться на конкретную страницу. Например:
+  <ul>
+   <li>Если вы пишете об элементах HTML, вы можете захотеть сослатся на наш индекс всех элементов HTML (<a href="/ru/docs/Web/HTML/Element">https://developer.mozilla.org/ru/docs/Web/HTML/Element</a>), либо на конкрентый элемент, например {{HTMLElement("colgroup")}}.</li>
+   <li>Аналогично, если вы пишете о CSS, вы можете сослаться как на наш справочник по CSS (большой индекс: <a href="/ru/docs/Web/CSS/Reference">https://developer.mozilla.org/ru/docs/Web/CSS/Reference</a>), так и на конкретное свойство, о котором вы пишете, например {{cssxref("list-style-type")}}.</li>
+  </ul>
+ </li>
+</ul>
+<p><strong>Но на самом деле, вы должны ссылаться на наиболее подходящую к вашему содержимому и для ваших пользователей страницу.</strong> Не забывайте, что важны ваши читатели, а не ссылки на нас.</p>
+
+<h2 id="How_do_I_create_a_good_link.3F" name="How_do_I_create_a_good_link.3F">Как создать хорошую ссылку?</h2>
+<p>Создание ссылок — дело тривиальное, но создание хороших ссылок — это нечто более сложное. Существует несколько способов создать ссылки:</p>
+
+<h3 id="Linking_in_the_text" name="Linking_in_the_text">Ссылки в тексте</h3>
+<p>Это самый полезный вид ссылок: они нацелены на предоставление пользователям дополнительной информации по данной концепции. В основном такие ссылки ведут на страницы, содержащие связанную информацию, а не на домашнюю страницу веб-сайта (хотя, конечно, есть и исключения).</p>
+<blockquote>
+ <p>… с помощью API <a href="/ru/docs/IndexedDB">IndexedDB</a> данные можно хранить в локальной базе данных…</p>
+</blockquote>
+<p>Такие ссылки очень ценны как для пользователя, который получает информацию, доступную в один щелчок мыши, так и для MDN, так как пользователям, пришедших к нам по точному контексту, скорее всего понравится наше содержимое. Поскольку наша миссия состоит в том, чтобы читатели нашли то, что им нужно, как можно быстрее, это определённо очень хорошая вещь.</p>
+
+<h4 id="What_not_to_do_when_linking_in_the_text" name="What_not_to_do_when_linking_in_the_text">Что не надо делать при проставлении ссылок в тексте</h4>
+<p>Проставление ссылок в тексте действительно очень клёво и полезно, но есть несколько вещей, которых нужно избегать:</p>
+<ul>
+ <li><strong>Не ставьте слишком много ссылок.</strong> <a href="/ru/docs/Web/CSS/:not" title=":not()">Не</a> <a href="/ru/docs/Web/JavaScript/Reference/Statements/do...while" title="do...while">ставьте</a> <a href="/ru/docs/Web/CSS/:link" title=":link">ссылки</a> на каждое слово или почти каждое слово. Это раздражает. Тщательно выбирайте и ставьте ссылку только на основные понятия в вашем тексте, либо специально выбирайте ссылки на страницы о понятиях, о которых читатель ещё, вероятно, не знает.</li>
+ <li><strong>Не ссылайтесь на один и тот же термин снова и снова.</strong> Если вы пишете об анимациях на CSS, не нужно ставить ссылку на каждое вхождение слова «анимация» на <a href="/ru/docs/Web/CSS/animation">свойство CSS <code>animation</code></a>. Если читатели не знают понятие, они скорее щёлкнут на первое вхождение для получения релевантной информации. Далее по тексту вы можете безопасно предполагать, что читатель уже знает о понятии, либо ещё до чтения страницы, либо сходив по предыдущей ссылке. Время от времени вы можете вставлять ссылку на термин (максимум одну на несколько абзацев), так что если читателю позже нужно будет перейти по ссылке, ему не надо будет долго прокручивать страницу.</li>
+ <li><strong>Будьте внимательны, проставляя ссылки на форумах и в комментариях к блогам.</strong> Предоставление релевантных ссылок на постоянные ресурсы по конкретному вопросу или проблеме — это здорово и всячески приветствуется. Блуждание по сети и заваливание ссылками на MDN наоборот, не ценится: и владельцы сайтов, и читатели быстро признают в вас спамера и репутация MDN будет подмочена. Мы прилагаем гиганские усилия для построения ценного ресурса и у нас нет никакого желания, чтобы они разрушались таким поведением, поэтому, пожалуйста, размещайте только релевантные ссылки в соответствующее время.</li>
+</ul>
+
+<h3 id="Adding_a_banner_or_an_image_to_your_site" name="Adding_a_banner_or_an_image_to_your_site">Добавление баннера или изображения на ваш сайт</h3>
+<p>Другим способом сослаться на MDN является добавление изображения со ссылкой вне основного текста страницы, например, в боковую панель. Он имеет другое значение: тогда как проставление ссылок в тексте является способом предоставления дополнительной информации вашим пользователям, добавление изображения со ссылкой в боковую панель — это способ показать вашу поддержку проекту MDN или способ продвинуть MDN. Также это способ предложения MDN в качестве единого ресурса со всей информацией.</p>
+<p>Не стесняйтесь показывать нам вашу поддержку: посетите страницу <a href="/ru/docs/MDN/Promote">продвижения MDN</a> и создайте кнопку специально для вашего сайта. Конечно, вы вольны разместить ссылку на другую страницу, например, на одну из целевых страниц.</p>
+
+<h3 id="Automatically_linking_to_MDN_from_WordPress" name="Automatically_linking_to_MDN_from_WordPress">Автоматическое проставление ссылок на MDN из WordPress</h3>
+<p>Мы создали <a href="/ru/docs/MDN/Promote#WordPress_plugin">плагин WordPress</a>, который автоматически проставляет ссылки на выбранные термины в записях вашего блога на соответствующие страницы MDN. Делает он это разумно, в соответствии с рекомендациями, изложенными выше и может быть большим подспорьем для блоггеров, пишущих о концепциях веба. Взгляните на него, и попробуйте установить, если вы думаете, что он может быть полезен.</p>
+<p>Большое спасибо вам за вашу поддержку!</p>
diff --git a/files/ru/mdn/user_guide/writing/index.html b/files/ru/mdn/user_guide/writing/index.html
new file mode 100644
index 0000000000..b83e7bcfc8
--- /dev/null
+++ b/files/ru/mdn/user_guide/writing/index.html
@@ -0,0 +1,49 @@
+---
+title: Написание статей
+slug: MDN/User_guide/Writing
+tags:
+  - MDN
+translation_of: Archive/Meta_docs/Writing_content
+---
+<div>{{MDNSidebar}}</div><p>На MDN всегда существуют вещи, которые добавляются или обновляются. Будь то новая документация по новому сверкающему API или пересмотр старого, слегка изменившегося, API, вы всегда найдёте множество возможностей для помощи.</p>
+
+<h2 id="Editing_an_existing_page" name="Editing_an_existing_page">Редактирование существующей страницы</h2>
+<p>Если вы нашли страницу, которую хотели бы пересмотреть, просто нажмите на кнопку «Редактировать» в её верхнем правом углу. Это действие откроет WYSIWYG-редактор для работы над содержимым страницы. Для подробностей о том, как работать с редактором, а также с системой макросов, которую мы используем для автоматизации некоторырых конструкций форматирования содержимого, смотрите <a href="/ru/docs/Project:MDN/Contributing/Editor_guide">руководство по редактору MDN</a>.</p>
+<p>Существует множество причин, по которым вы можете захотеть отредактировать существующую страницу:</p>
+<ul>
+ <li>Вы обнаружили ошибку или опечатку.</li>
+ <li>Вы хотите изменить формулировку для её лучшего понимания.</li>
+ <li>Компоновка или форматирование страницы ужасно.</li>
+ <li>Задокументированный API изменился и документация нуждается в обновлении, чтобы она соотвествовала этим изменениям.</li>
+ <li>Вы хотите добавить информацию о разнице в поведении API между браузерами.</li>
+ <li>Вы хотите добавить или улучшить примеры кода. Для подробностей смотрите раздел {{anch("Add_a_code_sample", "добавление примера кода")}} ниже.</li>
+ <li>Статья является заглушкой, либо просто упускает некоторые важные детали.</li>
+</ul>
+
+<h2 id="Adding_a_new_page" name="Adding_a_new_page">Добавление новой страницы</h2>
+<p>Это очень здорово! Добавление новой страницы на MDN делает веб чуточку лучше. Есть несколько очевидных причин для создания новой страницы, включая документирование API, который ещё не был задокументирован, либо добавление нового урока или руководства по теме.</p>
+<p>Существует несколько способов создания новой страницы на MDN, но все они доступны только когда вы <a href="/ru/docs/Project:MDN/Contributing/Getting_started#Logging_into_MDN">вошли в систему</a>:</p>
+<dl>
+ <dt>Нажатие на ссылку, ведущую на «несуществующую страницу»</dt>
+ <dd>При просмотре MDN, иногда вы будете находить ссылки на ещё несуществующие страницы. Довольно часто при создании статьи мы включаем в неё ссылки на страницы, которые нужно создать, но которые мы ещё не создали. Это помогает нам следить за теми вещами, что, в конечном итоге, должны быть сделаны, хотя иногда, чтобы вернуться к ним, требуется время. Вы можете не стесняться и сами сделать это! Просто нажмите на ссылку, и вы попадёте прямо в редактор для новой страницы.</dd>
+ <dt>Создание дочерней страницы</dt>
+ <dd>В верхнем правом углу каждой статьи находится выпадающее меню «Эта страница». В этом меню есть пункт <strong>«Новая подстраница»</strong>. Нажатие на этот пункт меню открывает редактор для новой страницы, чьим родителем в иерархии сайта будет страница, на которой вы нажали пункт меню <strong>«Новая подстраница»</strong>. Просто заполните название и короткую ссылку и начните создавать содержимое страницы.</dd>
+ <dt>Создание клона страницы</dt>
+ <dd>Вы также можете склонировать существующую страницу, используя пункт <strong>«Клонировать эту страницу»</strong> в выпадающем меню «Эта страница». Нажатие на этот пункт создаст копию текущей страницы, чьим родителем будет та же страница, что и у текущей страницы и откроет редактор, в котором вы сможете проставить название и короткую ссылку склонированной страницы, а также отредактировать её содержимое. Как правило, это хороший способ добавления новой страницы в уже существующую область сайта, например потому, что вы получаете образец компоновки для нового содержимого.</dd>
+ <dt>Создание ссылки на несуществующую страницу, затем нажатие на неё</dt>
+ <dd>Это в некотором роде гибридный метод. Поскольку каждая страница должна быть связана с какой-нибудь другой, вы можете начать с создания ссылки на новую статью на уже существующей странице, а затем, после сохранения той страницы, вы можете нажать на только что созданную ссылку и открыть редактор для новой статьи.</dd>
+</dl>
+<div class="note">
+ <p><strong>Примечание:</strong> если вы не вошли в систему, вы получите ошибку 404 при попытке просмотреть несуществующую статью, вместо появления редактора для создания новой страницы.</p>
+</div>
+
+<h2 id="Finding_information" name="Finding_information">Поиск информации</h2>
+<p>На сайте содержится просто огромное количество информации и поэтому может быть сложно выцепить точную необходимую вам помощь. Вот несколько подсказок, с чего можно начать.</p>
+<dl>
+ <dt><a href="https://wiki.mozilla.org/Modules">Списки владельцев модулей</a></dt>
+ <dd>Проекты Mozilla работают на базе так называемых «владельцев модулей»; каждый главный компонент имеет владельца или владельцев, которые отвечают за то, что с ним происходит. Владельцы часто являются лучшим источником информации — или, по крайней мере, они помогут найти нужного человека, с которым можно поговорить.</dd>
+ <dt><a href="http://mxr.mozilla.org/">Перекрёстные ссылки между исходниками Mozilla</a></dt>
+ <dd>MXR, перекрёстные ссылки проектов Mozilla, позволяет вам получить доступ к всем исходным кодам проекта Mozilla (за исключением некоторых вещей, главным образом связанных с ОС Firefox, которые находятся на GitHub). Код и комментарии в коде часто являются отличным информационным ресурсом.</dd>
+ <dt><a href="http://wiki.mozilla.org/">Вики Mozilla</a></dt>
+ <dd>Вики Mozilla — часто на неё ссылаются как на «wikimo» — это хранилище замечаний по процессу и дизайну, черновиков, планов и предварительных спецификаций. Несмотря на то, что часто там сам чёрт ногу сломит, она является кладезем бесценной информации.</dd>
+</dl>
diff --git a/files/ru/mdn/user_guide/zone_administration/index.html b/files/ru/mdn/user_guide/zone_administration/index.html
new file mode 100644
index 0000000000..95704a390d
--- /dev/null
+++ b/files/ru/mdn/user_guide/zone_administration/index.html
@@ -0,0 +1,207 @@
+---
+title: Управление зонами
+slug: MDN/User_guide/Zone_administration
+tags:
+  - Documentation
+  - MDN
+translation_of: Archive/MDN/Zones
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary"><strong>Зона</strong> — это специальная область MDN, чьё содержимое представлено с некоторыми дополнительными элементами управления, например, специальным блоком навигации по зоне и визуально улучшенной шапкой страницы. В этом руководстве рассматривается, как создавать и поддерживать зоны.</span></p>
+
+<p>К примеру, область MDN <a href="/ru/docs/MDN">Проект MDN</a> представлена зоной.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> реализация зон — а также определение того, как они должны использоваться — всё ещё в активной разработке и может значительно измениться. Пожалуйста, если у вас есть вопросы о том, что здесь написано, задавайте их на канале #mdn в IRC, особенно, если вы планируете создать зону или превратить в неё какой-нибудь существующий материал.</p>
+</div>
+
+<h2 id="Zone_features" name="Zone_features">Возможности зон</h2>
+
+<p>После того, как вы создадите зону (её создание описывается ниже), вы получаете различные специальные возможности и преимущества, которые можно и нужно использовать:</p>
+
+<ul>
+ <li>Область заголовка, окрашиваемая в цвет, однозначно определяющий вашу зону.</li>
+ <li>Представляющий зону баннер в области заголовка.</li>
+ <li>Целевая страница зоны, построенная на основе навигационной иерархии зоны и представляющая большую, чем обычно, зону для большого баннера, а также место под краткое описание зоны.</li>
+ <li>Специальная боковая панель с навигацией; зоны могут включать в эту навигацию содержимое из любой части MDN, даже если оно не находится в иерархии зоны.</li>
+ <li>Дочерние страницы целевой страницы зоны — то есть, страницы, физически расположеные под целевой страницей — наследуют цвет зоны и её баннер, маленькую область сверху страницы.</li>
+</ul>
+
+<p><strong>Добавить схему/диаграмму компоновки</strong></p>
+
+<p>Существует два основных типа зон: <strong>зоны внутри вики</strong> и <strong>зоны мини-сайта</strong>.</p>
+
+<h3 id="In-wiki_zones" name="In-wiki_zones">Зоны внутри вики</h3>
+
+<p><strong>Зона внутри вики</strong> — это зона, использующая преимущества функциональности зон, в тоже время оставаясь частью основного потока содержимого документации MDN. Например, эта зона, зона «<a href="/ru/docs/MDN">Проекта MDN</a>», является зоной внутри вики. Они являются своего рода полузонами в том смысле, что обычно они не включают содержимое извне своей собственной иерархи.</p>
+
+<p>Зоны внутри вики позволяют сегментировать MDN для добавления дополнительных визуальных украшательств и, что более важно, боковых панелей навигации без выдёргивания пользователя из основного потока содержимого MDN.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> зоны внутри вики обычно не появляются в списке «Зоны» на домашней странице MDN, поскольку они рассматриваются как часть основного тела содержимого документации MDN.</p>
+</div>
+
+<h3 id="Mini-site_zones" name="Mini-site_zones">Зоны мини-сайта</h3>
+
+<p><strong>Зона мини-сайта</strong> — это зона, которая, хотя и редактируется и управляется при помощи того же самого интерфейса, что и любая другая вики-страница на MDN, представлена вне основного потока содержимого документации. Во всех функциональных отношениях она поддерживает всю стандартную функциональность вики, предоставляемую платформой <a href="/ru/docs/MDN/Kuma">Kuma</a>, на которой построен MDN. Хорошим примером зоны может служить <a href="/ru/Apps">Центр приложений</a>.</p>
+
+<p>При создании зоны мини-сайта она получает новый URL за пределами дерева "/docs/" на MDN, обычно он выглядит как <code>https://developer.mozilla.org/<em>&lt;локаль&gt;</em>/zone/<em>&lt;название_вашей_зоны&gt;</em></code>.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> в общем случае только очень значительное, специализированное содержимое должно быть перемещено за пределы иерархии вики; эти зоны предназначены в первую очередь для настройки специализарованных рекламных компаний и/или связанного с программой содержимого.</p>
+</div>
+
+<h2 id="What_should_be_a_zone.3F" name="What_should_be_a_zone.3F">Что должно быть зоной?</h2>
+
+<p>Это интересный вопрос, и, честно говоря, ответ на него будет меняться с течением времени. Зоны являются новой концепцией для MDN и мы всё ещё изучаем, как именно мы будем их использовать.</p>
+
+<p>Существует две основные причины создания зон:</p>
+
+<ol>
+ <li>Вам нужно настроить <strong>мини-сайт</strong> для рекламной кампании или конкретного продукта.</li>
+ <li>Вы хотите создать, так сказать, единое окно доступа к теме, охватывающей несколько областей технологии.</li>
+</ol>
+
+<h2 id="Creating_a_zone" name="Creating_a_zone">Создание зоны</h2>
+
+<p>Первым шагом является создание содержимого. Как минимум, вы должны создать начальную целевую страницу, которая станет корневой страницей вашей зоны. Если у вас есть хотя бы корневая страница и, возможно, даже несколько дочерних страниц, вы можете превратить их в зону.</p>
+
+<p>Для превращения раздела MDN в зону требуются привилегии администратора MDN, так что вам нужно попросить администратора MDN сделать это за вас. В запросе на превращение раздела в зону вы должны предоставить администратору несколько вещей:</p>
+
+<ul>
+ <li>Какая страница MDN должна быть превращена в корневую страницу новой зоны. Имейте ввиду, что все страницы, ниже её по иерархии, станут частью зоны.</li>
+ <li>Является ли ваша зона {{anch("In-wiki_zones", "зоной внутри вики")}} или {{anch("Mini-site_zones", "зоной мини-сайта")}}?</li>
+ <li>Так же вы должны предоставить информацию о стилях и картинки для настройки области шапки будущей зоны. Для подробностей смотрите раздел {{anch("Customizing_the_appearance", "Изменение внешнего вида")}}.</li>
+</ul>
+
+<div class="note">
+<p><strong>Примечание:</strong> поскольку зоны являются конструкциями специального назначения, вам, вероятно, будет предложено обосновать, почему содержимое должно быть выделено в отдельную зону. Для понимания вопроса обратитесь к разделу {{anch("What_should_be_a_zone.3F", "Что должно быть зоной?")}}</p>
+</div>
+
+<h2 id="Changing_the_zone_access_policy" name="Changing_the_zone_access_policy">Изменение политики доступа к зоне</h2>
+
+<p>В настоящий момент нет никакой поддержки разграничения прав доступа к зонам. Эту функциональность планируется добавить в будущем. Если вам нужно разграничение прав, пожалуйста, дайте нам знать, чтобы мы могли скорректировать приоритеты для этой работы.</p>
+
+<h2 id="Customizing_the_appearance" name="Customizing_the_appearance">Настройка внешнего вида</h2>
+
+<p>Частью того, что делает зону зоной, является возможность настройки её внешнего вида. Как минимум, она подразумевает настройку особого цвета и фонового изображения в шапке страниц зоны, помогающие пользователю понять, что он находится в определённой зоне. Также можно сделать и другие изменения внешнего вида страницы, однако они не должны выбиваться из общего стиля MDN.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> важно иметь в виду, что инструкции, изложенные ниже, являются всего лишь <strong>подсказками</strong>. Вы можете попытаться более тонко настроить CSS для своей зоны. Просто имейте в виду, что ваши изменения могут быть пересмотрены нашими командами по UX и/или дизайну и они должны вписываться в общий стиль MDN.</p>
+</div>
+
+<h3 id="Basic_customization" name="Basic_customization">Базовая настройка</h3>
+
+<p>Базовая требуемая настройка для каждой зоны — это настройка цвета фона и изображения в шапке страниц зоны. Во время запроса создания зоны вас попросят предоставить эти данные. Далее изложены основные рекомендации по тому, что вы должны предоставить.</p>
+
+<ul>
+ <li>Фоновый цвет должен явно отличаться от фонового цвета остальных зон и в тоже время иметь отношение к освещаемой зоной теме. Вы должны определить его как {{cssxref("&lt;color&gt;")}}, чтобы администратор MDN мог настроить вашу зону.</li>
+ <li>По умолчанию, фоновое изображение появляется с правой стороны шапки (или с левой стороны в локалях с написанием текста справа-налево). Это изображение может быть в любом совместимом с веб формате, хотя обычно предпочтителен формат PNG. Оно должно либо смешиваться с вашим фоновым цветом, либо (что предпочтительнее) иметь прозрачный фон. Как правило, фоновое изображение должно быть около 468 пикселей в ширину и 400 пикселей в высоту, хотя в CSS на странице может быть проставлено значение {{cssxref("overflow")}} для его обрезки при необходимости. Тем не менее, создание слишком большого изображения увеличивает размер страницы, чего следует избегать.</li>
+ <li>Изображение может быть отправлено администратору MDN во время вашего запроса на создание зоны, или оно может быть одним из уже загруженных на MDN с соответствующей страницей вложений.</li>
+</ul>
+
+<p>Имея эту информацию, команда администраторов MDN сможет установить для вас базовый CSS вашей зоны. Однако, если вы хотите, вы можете пойти дальше и предоставить свой собственный CSS. Следуя инструкциям в разделе {{anch("Additional_customizations", "Дополнительные изменения")}}, вы можете поэкспериментировать с другими изменениями визуального стиля вашей зоны.</p>
+
+<h3 id="Additional_customizations" name="Additional_customizations">Дополнительные изменения</h3>
+
+<p>Если вы хотите исследовать дополнительные возможности настройки, взгляните на шаблоны CSS/stylus, расположенные <a href="https://github.com/mozilla/kuma/blob/master/media/redesign/stylus/zones.styl">на github</a>. Это список всех CSS Stylus для стилей, которые вам позволено менять при помощи вашего CSS для зоны.</p>
+
+<p>Если вы хотите сделать дополнительные настройки, вы можете это сделать, но с одной важной оговоркой: ваши изменения не должны настолько значительными, что страницы зоны перестают выглядеть как часть MDN.</p>
+
+<p>При изменении таблицы стилей зоны вашими задачами становятся выделить те стили из шаблона, которые вы хотите изменить и поместить их в результирующий CSS. Как только вы сделаете это, предоставьте получившийся CSS команде администраторов MDN и они установят его для вас.</p>
+
+<p>Всё содержимое, относящееся к зонам, имеет класс <code>zone</code>.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> пожалуйста, обратите внимание, что поскольку сайт находится в стадии активной разработки, любые обсуждаемые здесь классы и стили могут быть изменены без предварительного уведомления.</p>
+</div>
+
+<h4 id="Background_colors" name="Background_colors">Фоновые цвета</h4>
+
+<p>Как ранее упоминалось, первым делом вы, вероятно, захотите настроить фоновый цвет шапки вашей зоны. CSS может выглядеть подобным образом:</p>
+
+<pre class="brush: css">.zone #main-header, .zone .zone-article-header, .zone .zone-landing-header {
+    background-color: <strong><em>цвет-зоны</em></strong>;
+}
+</pre>
+
+<p>Идентификатор <code>main-header</code> ссылается на область навигации по сайту в самом верху страницу. Она включает вкладку «Mozilla» для междусайтовой навигации, поле поиска и другую глобальную функциональность по навигации.</p>
+
+<p>Класс <code>zone-article-header</code> представляет внешний вид шапки на страницах со статьями внутри зоны. То есть, все страницы, кроме целевой страницы зоны, будут в своей шапке иметь этот класс.</p>
+
+<p>Класс <code>zone-landing-header</code> используется в шапке целевой страницы зоны. Это более высокая шапка на целевой странице с большим изображением внутри неё.</p>
+
+<p>Как правило, вы захотите, чтобы эти области имели одинаковый цвет; и в самом деле, шапки статьи и целевой страницы должны быть одинаковыми. Единственной причиной, по которой вы могли бы настроить их по разному, является наличие градиентов и необходимость подогнать их цвет к некоторому «общему знаменателю», несмотря на различие по высоте.</p>
+
+<p><strong>Короче говоря:</strong> замените <strong><em>цвет-зоны</em></strong> в кусочке CSS, предоставленном выше, на {{cssxref("&lt;color&gt;")}}, который вы выбрали для вашей зоны.</p>
+
+<h4 id="Landing_page_header_image" name="Landing_page_header_image">Изображение в шапке целевой страницы</h4>
+
+<p>Также вы можете захотеть изменить изображение, представляющее вашу зону на целевой странице зоны. Эта страница имеет большую шапку для большого изображения, представляющего вашу зону. CSS выглядит так:</p>
+
+<pre class="brush: css">.zone .zone-landing-header .zone-image {
+    background-image: url(<strong><em>url-изображения-зоны</em></strong>);
+}
+</pre>
+
+<p>Класс <code>zone-image</code> используется для определения и стилизации изображения в шапке целевой страницы вашей зоны. Изображение должно быть не более 468 пикселей в ширину, хотя вы и можете изменить это здесь же с помощью дополнительного CSS. Просто замените <strong><em>url-изображения-зоны</em></strong> на URL используемого вами изображения.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> простейшим способом предоставить изображение является прикрепление его к соответствующей странице на MDN и использования получившегося URL.</p>
+</div>
+
+<h4 id="Article_page_header_image" name="Article_page_header_image">Изображение в шапке страницы статьи</h4>
+
+<p>Кроме того, вы должны установить изображение, представляющее вашу зону на дочерних страницах. По умолчанию, это изображение ограничено 200 пикселями в ширину и 400 пикселям ив высоту, но, опять же, это может быть изменено.</p>
+
+<pre class="brush: css">.zone .zone-article-header .zone-image {
+    background-image: url(<strong><em>url-изображения-зоны</em></strong>);
+}
+</pre>
+
+<p>Просто замените <strong><em>url-изображения-зоны</em></strong> на URL используемого вами изображения.</p>
+
+<div class="note">
+<p><strong>Примечание:</strong> простейшим способом предоставить изображение является прикрепление его к соответствующей странице на MDN и использования получившегося URL. Вы можете использовать тоже самое изображение что и в шапке целевой страницы, просто отмасштабировав и обрезав его, либо использовать другое изображение.</p>
+</div>
+
+<h4 id="Header_button_bottom_border" name="Header_button_bottom_border">Нижняя граница кнопки в шапке</h4>
+
+<p>Последнее, что мы рекомендуем вам поменять, — это внешний вид нижней границы кнопок в шапке зоны. Вот CSS:</p>
+
+<pre class="brush: css">.zone .zone-landing-header a.button {
+    box-shadow: inset 0 -1px <strong><em>цвет</em></strong>;
+}
+</pre>
+
+<p>Здесь замените <strong><em>цвет</em></strong> на {{cssxref("&lt;color&gt;")}} того же оттенка, что и фоновый, но чуточку темнее.</p>
+
+<h2 id="Zone_navigation" name="Zone_navigation">Навигация по зоне</h2>
+
+<h3 id="Zone_navigation_sidebar" name="Zone_navigation_sidebar">Боковая панель навигации по зоне</h3>
+
+<p>Боковая панель, появляющаяся на каждой странице зоны, определяется в содержимом целевой страницы зоны, в разделе с названием «Subnav» (виден только при редактировании страницы). Этот раздел может содержать вручную составленный куратором список страниц, либо использовать макрос, например {{TemplateLink("ListSubpages")}}. В последнем случае вам нужно будет <a href="/ru/docs/MDN/Kuma/Introduction_to_KumaScript#Caching">принудительно перезагрузить</a> (обновление с шифтом) целевую страницу зоны, чтобы увидеть изменения в боковой панели.</p>
+
+<div class="note">
+<p><strong>Примечание переводчика:</strong> Раздел «Subnav» не обязательно должен так называться, достаточно проставить атрибут <code>id="Subnav"</code> у заголовка. Однако, редактор MDN принудительно сбрасывает идентификатор в название раздела при сохранении страницы. Чтобы он этого не делал, достаточно добавить к заголовку атрибут <code>name="Subnav"</code>, в этом случае в качестве идентификатора будет использоваться значение этого атрибута.</p>
+</div>
+
+<h3 id="Quicklinks" name="Quicklinks">Быстрые ссылки</h3>
+
+<p>Как и любая другая страница на MDN, страницы внутри зоны могут использовать возможность <a href="/ru/docs/MDN/Contribute/Content/Quicklinks">быстрых ссылок</a>. Быстрые ссылки — это навигационный блок, расположенный в левой боковой панели, предлагающий пользователю ссылки на сопутствующие материалы. Эти ссылки могут вести внутрь MDN или на внешние сайты и могут иметь до двух уровней вложенности.</p>
+
+<p>Чтобы облегчить создание наиболее распространённых типов быстрых ссылок для зон, мы написали несколько макросов, которые вы также можете использовать.</p>
+
+<h4 id="QuickLinksWithSubpages" name="QuickLinksWithSubpages">Макрос <code>QuickLinksWithSubpages</code></h4>
+
+<p>Макрос {{TemplateLink("QuickLinksWithSubpages")}} создаёт весь требуемый HTML для блока быстрых ссылок на странице со ссылками на страницы в указанной иерархии. Вы также можете использовать его без параметров для генерирования быстрых ссылок на дочерние страницы текущей страницы, хотя это не так полезно в зоне, поскольку навигация по зоне, как правило, уже предоставляет эти ссылки.</p>
+
+<h2 id="Zone_style_guide" name="Zone_style_guide">Руководство по оформлению зон</h2>
+
+<h2 id="Notes" name="Notes">Примечания</h2>
+
+<p>В этом разделе содержатся примечания, которые следует иметь в виду при создании зон и работе с ними.</p>
+
+<ul>
+ <li>Каждая страница в зоне автоматически наследует боковую панель навигации, предоставляемую корневой страницей зоны.</li>
+ <li>Если страница в зоне имеет раздел быстрых ссылок, быстрые ссылки отображаются под навигацией по зоне в боковой панели. Отключение быстрых ссылок отключает как быстрые ссылки, так и панель навигации, оставляя больше пространства под содержимое страницы.</li>
+</ul>