Skip to content

Commit

Permalink
[ru] replace old noteblock syntax with GFM syntax in mdn folder (#2…
Browse files Browse the repository at this point in the history
…2791)

[ru] replace old noteblock syntax with GFM syntax in 'mdn' folder
  • Loading branch information
leon-win authored Aug 8, 2024
1 parent c213ed4 commit aabea44
Show file tree
Hide file tree
Showing 3 changed files with 4 additions and 23 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -55,8 +55,6 @@ slug: MDN/Writing_guidelines/Howto/Creating_moving_deleting

Нажатие клавиши **Enter** в поле ввода комментария к ревизии то же самое, что нажатие кнопку **Сохранить и продолжить редактирование**.

> **Примечание:** Если при попытке сохранить изменения, они были не приняты как некорректные, но вы считаете, что правки полностью приемлемы для MDN, [обратитесь к администрации MDN](mailto:[email protected]?subject=MDN%20Content%20Rejection%20Appeal&body=Describe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.) за помощью.
## Получение прав на создание страниц

По причинам безопасности недавно созданные аккаунты не имеют права добавлять новые страницы. Если вы попытаетесь сделать это, то увидите страницу с инструкцией, как создать страницу. Есть два варианта:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,10 @@ MDN [глоссарий](/ru/docs/Glossary) (глоссарий) — это ме

### Шаг 2: Дайте краткое определение

Первый абзац любой страницы глоссария – это простое и краткое определение/описание термина (желательно не длиннее двух предложений). Удостоверьтесь, что любой, кто читает определение, сможет сразу понять определяемый термин.
Первый абзац любой страницы глоссария – это простое и краткое описание термина (желательно не длиннее двух предложений). Удостоверьтесь, что любой, кто читает определение, сможет сразу понять определяемый термин.

> **Примечание:** Пожалуйста, не копируйте определения из других источников (особенно из Википедии, поскольку её спектр лицензионных версий меньше, и, таким образом, несопоставим с MDN). Ваша запись должна быть уникальной, а не скопированной.
> [!NOTE]
> Пожалуйста, не копируйте определения из других источников (особенно из Википедии, поскольку её спектр лицензионных версий меньше и несопоставим с MDN). Ваша запись должна быть уникальной, а не скопированной.
#### Как создать _хорошую_ запись глоссария

Expand All @@ -37,14 +38,6 @@ MDN [глоссарий](/ru/docs/Glossary) (глоссарий) — это ме
- Используйте подходящие связанные термины (со ссылками) в вашей записи, но только если уверены, что это не затруднит восприятие. Наличие хорошей сети связанных, полезных ссылок может сделать страницу или набор страниц намного более простыми в использовании.
- Подумайте о том, что бы вы ввели в поисковую систему, если бы хотели найти эту страницу. Попробуйте использовать все эти ключевые слова в записи, но постарайтесь сделать это так, чтобы запись при этом не утратила смысл, не стала слишком длинной или трудной для чтения.

#### Отредактируйте всплывающие подсказки

Как и в случае с большинством ссылок MDN, наведение курсора мыши на ссылку глоссария покажет краткое описание страницы (в данном случае краткое описание определения термина). По умолчанию подсказка представляет собой весь первый абзац статьи, но в большинстве случаев такое описание может оказаться слишком большим.

Вы можете сами указать фрагмент текста, который в дальнейшем будет использоваться как текст всплывающей подсказки при ссылке на вашу запись. Выберите одно или два предложения в записи, которые лучше всего описывают термин, а затем добавьте к ним стиль "SEO Summary" (резюме). Это действие не только создаст текст подсказки, но и определит текст, который будет отправлен в Google и другие поисковые системы, когда они запросят краткое резюме, описывающее содержимое страницы. Таким образом, вашу запись будет легче находить с помощью поисковиков.

> **Примечание:** В идеале, резюме должно содержать около 150-160 символов. Лучше меньше, да лучше.
### Шаг 3: Добавьте ссылки

Заканчиваться запись в глоссарии всегда должна разделом "Узнать больше". Этот раздел должен содержать ссылки, которые помогут читателю подробнее изучить вопрос: узнать больше деталей, научиться использовать соответствующие технологии и так далее.
Expand Down
12 changes: 1 addition & 11 deletions files/ru/mdn/writing_guidelines/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: О MDN
title: Руководства по составлению документации
slug: MDN/Writing_guidelines
---

Expand Down Expand Up @@ -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/`.
Expand All @@ -49,14 +47,6 @@ slug: MDN/Writing_guidelines

Некоторое более раннее содержимое было предоставлено по лицензии, отличной от указанных выше лицензий; они указаны внизу каждой страницы в виде [Alternate License Block](/Archive/Meta_docs/Examples/Alternate_License_Block).

> **Предупреждение:** Никакие новые страницы не могут быть созданы с использованием альтернативных лицензий.
**Авторское право на предоставленные материалы остаётся у автора, если автор не присваивает его кому-либо ещё**.

Если у вас есть какие-либо вопросы или предложения по поводу поднятого здесь вопроса, пожалуйста, свяжитесь с [Eric Shepherd](mailto:[email protected]).

---

Права на товарные знаки, логотипы, определения, принадлежащие Mozilla Foundation, а также внешний вид этого сайта, не лицензированы в соответствии с Creative Commons license, и в том виде, в котором они являются произведениями авторства (например, логотипы и графический дизайн), также они не включены в работу, которая лицензируется в соответствии с этими условиями. Если вы используете текст документов и хотите также использовать любые из этих прав, или у вас есть другие вопросы касающиеся соблюдении наших условий лицензирования для всего перечисленного, свяжитесь с Mozilla Foundation: <[email protected]>.

### Ссылки на MDN
Expand Down

0 comments on commit aabea44

Please sign in to comment.