Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ru] replace old noteblock syntax with GFM syntax in mdn folder #22791

Merged
merged 1 commit into from
Aug 8, 2024
Merged

[ru] replace old noteblock syntax with GFM syntax in mdn folder #22791

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions files/ru/mdn/writing_guidelines/howto/creating_moving_deleting/index.md
View file
Open in desktop
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
13 changes: 3 additions & 10 deletions files/ru/mdn/writing_guidelines/howto/write_a_new_entry_in_the_glossary/index.md
View file
Open in desktop
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
View file
Open in desktop
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