diff --git a/files/ru/mdn/writing_guidelines/howto/creating_moving_deleting/index.md b/files/ru/mdn/writing_guidelines/howto/creating_moving_deleting/index.md index 067ea68ee4e253..a445ac1c1cec28 100644 --- a/files/ru/mdn/writing_guidelines/howto/creating_moving_deleting/index.md +++ b/files/ru/mdn/writing_guidelines/howto/creating_moving_deleting/index.md @@ -55,8 +55,6 @@ slug: MDN/Writing_guidelines/Howto/Creating_moving_deleting Нажатие клавиши **Enter** в поле ввода комментария к ревизии то же самое, что нажатие кнопку **Сохранить и продолжить редактирование**. -> **Примечание:** Если при попытке сохранить изменения, они были не приняты как некорректные, но вы считаете, что правки полностью приемлемы для MDN, [обратитесь к администрации MDN](mailto:mdn-admins@mozzila.com?subject=MDN%20Content%20Rejection%20Appeal&body=Describe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.) за помощью. - ## Получение прав на создание страниц По причинам безопасности недавно созданные аккаунты не имеют права добавлять новые страницы. Если вы попытаетесь сделать это, то увидите страницу с инструкцией, как создать страницу. Есть два варианта: diff --git a/files/ru/mdn/writing_guidelines/howto/write_a_new_entry_in_the_glossary/index.md b/files/ru/mdn/writing_guidelines/howto/write_a_new_entry_in_the_glossary/index.md index 4f8b6ca62c8aa7..f61dcd39bdb981 100644 --- a/files/ru/mdn/writing_guidelines/howto/write_a_new_entry_in_the_glossary/index.md +++ b/files/ru/mdn/writing_guidelines/howto/write_a_new_entry_in_the_glossary/index.md @@ -23,9 +23,10 @@ MDN [глоссарий](/ru/docs/Glossary) (глоссарий) — это ме ### Шаг 2: Дайте краткое определение -Первый абзац любой страницы глоссария – это простое и краткое определение/описание термина (желательно не длиннее двух предложений). Удостоверьтесь, что любой, кто читает определение, сможет сразу понять определяемый термин. +Первый абзац любой страницы глоссария – это простое и краткое описание термина (желательно не длиннее двух предложений). Удостоверьтесь, что любой, кто читает определение, сможет сразу понять определяемый термин. -> **Примечание:** Пожалуйста, не копируйте определения из других источников (особенно из Википедии, поскольку её спектр лицензионных версий меньше, и, таким образом, несопоставим с MDN). Ваша запись должна быть уникальной, а не скопированной. +> [!NOTE] +> Пожалуйста, не копируйте определения из других источников (особенно из Википедии, поскольку её спектр лицензионных версий меньше и несопоставим с MDN). Ваша запись должна быть уникальной, а не скопированной. #### Как создать _хорошую_ запись глоссария @@ -37,14 +38,6 @@ MDN [глоссарий](/ru/docs/Glossary) (глоссарий) — это ме - Используйте подходящие связанные термины (со ссылками) в вашей записи, но только если уверены, что это не затруднит восприятие. Наличие хорошей сети связанных, полезных ссылок может сделать страницу или набор страниц намного более простыми в использовании. - Подумайте о том, что бы вы ввели в поисковую систему, если бы хотели найти эту страницу. Попробуйте использовать все эти ключевые слова в записи, но постарайтесь сделать это так, чтобы запись при этом не утратила смысл, не стала слишком длинной или трудной для чтения. -#### Отредактируйте всплывающие подсказки - -Как и в случае с большинством ссылок MDN, наведение курсора мыши на ссылку глоссария покажет краткое описание страницы (в данном случае краткое описание определения термина). По умолчанию подсказка представляет собой весь первый абзац статьи, но в большинстве случаев такое описание может оказаться слишком большим. - -Вы можете сами указать фрагмент текста, который в дальнейшем будет использоваться как текст всплывающей подсказки при ссылке на вашу запись. Выберите одно или два предложения в записи, которые лучше всего описывают термин, а затем добавьте к ним стиль "SEO Summary" (резюме). Это действие не только создаст текст подсказки, но и определит текст, который будет отправлен в Google и другие поисковые системы, когда они запросят краткое резюме, описывающее содержимое страницы. Таким образом, вашу запись будет легче находить с помощью поисковиков. - -> **Примечание:** В идеале, резюме должно содержать около 150-160 символов. Лучше меньше, да лучше. - ### Шаг 3: Добавьте ссылки Заканчиваться запись в глоссарии всегда должна разделом "Узнать больше". Этот раздел должен содержать ссылки, которые помогут читателю подробнее изучить вопрос: узнать больше деталей, научиться использовать соответствующие технологии и так далее. diff --git a/files/ru/mdn/writing_guidelines/index.md b/files/ru/mdn/writing_guidelines/index.md index b9162f3af8d605..18d72bc20e7f60 100644 --- a/files/ru/mdn/writing_guidelines/index.md +++ b/files/ru/mdn/writing_guidelines/index.md @@ -1,5 +1,5 @@ --- -title: О MDN +title: Руководства по составлению документации slug: MDN/Writing_guidelines --- @@ -39,8 +39,6 @@ slug: MDN/Writing_guidelines Обратите внимание, что в этом примере ссылка "помощники Mozilla" ведёт на историю цитируемой страницы. Посмотрите [Best practices for attribution](http://wiki.creativecommons.org/Marking/Users) для дальнейшего разъяснения. -> **Примечание:** Посмотрите [MDN-содержимое на WebPlatform.org](/ru/docs/MDN_content_on_WebPlatform.org), чтобы получить информацию о том, как повторно использовать контент MDN, на этом сайте. - Образцы кода, добавленные в эту вики до 20 августа 2010 года, доступны под лицензией [MIT](http://www.opensource.org/licenses/mit-license.php); вы должны вставить следующую приписываемую информацию в MIT шаблон: "© <дата последней ревизии вики-страницы> <имя человека, создавшего её>". Образцы кода, добавленные после 20 августа 2010 года являются [общественным достоянием](http://creativecommons.org/publicdomain/zero/1.0/). Наличие уведомления о лицензии не требуется, но, если вы хотите, вы можете использовать это выражение: `Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/`. @@ -49,14 +47,6 @@ slug: MDN/Writing_guidelines Некоторое более раннее содержимое было предоставлено по лицензии, отличной от указанных выше лицензий; они указаны внизу каждой страницы в виде [Alternate License Block](/Archive/Meta_docs/Examples/Alternate_License_Block). -> **Предупреждение:** Никакие новые страницы не могут быть созданы с использованием альтернативных лицензий. - -**Авторское право на предоставленные материалы остаётся у автора, если автор не присваивает его кому-либо ещё**. - -Если у вас есть какие-либо вопросы или предложения по поводу поднятого здесь вопроса, пожалуйста, свяжитесь с [Eric Shepherd](mailto:eshepherd@mozilla.com). - ---- - Права на товарные знаки, логотипы, определения, принадлежащие Mozilla Foundation, а также внешний вид этого сайта, не лицензированы в соответствии с Creative Commons license, и в том виде, в котором они являются произведениями авторства (например, логотипы и графический дизайн), также они не включены в работу, которая лицензируется в соответствии с этими условиями. Если вы используете текст документов и хотите также использовать любые из этих прав, или у вас есть другие вопросы касающиеся соблюдении наших условий лицензирования для всего перечисленного, свяжитесь с Mozilla Foundation: . ### Ссылки на MDN