Проставление ссылок на MDN

Мы регулярно получаем от пользователей вопросы о том, как сослаться на MDN, или даже разрешено ли это делать. Краткий ответ таков: да, вы можете ссылаться на MDN! Читайте дальше, чтобы узнать о руководящих принципах и лучших практиках!

Могу ли я ссылаться на MDN?

Да! Разумеется! Дело не только в том, что гипертекст — это сущность веба, это так же способ указать вашим пользователям на ценные ресурсы и показать своё доверие к работе нашего сообщества.

Так что, да, мы определённо рекомендуем вам ссылаться на содержимое MDN. Не стесняетесь: ссылайтесь на главную страницу MDN, или, ещё лучше, сразу на конкретную страницу MDN, в случае необходимости. Смотрите ниже лучшие практики определения того, на какую страницу ссылаться.

На какую страницу мне надо ссылаться?

Не существует специальной страницы, на которую вы должны ссылаться. Важно то, насколько релевантна страница для ваших читателей.

Если вы пишете в общем об MDN, вы можете ссылаться на главную страницу, https://developer.mozilla.org/.
Если вы пишете в общем о какой-то конкретной теме, вы можете ссылаться на целевые страницы, то есть, специальные страницы, которые служат в качестве оглавления или индекса по этой теме. Несколько общих целевых страниц:
Если вы пишете о конкретной странице, элементе, методе и так далее, вы можете ссылаться на конкретную страницу. Например:
- Если вы пишете об элементах HTML, вы можете захотеть сослатся на наш индекс всех элементов HTML (https://developer.mozilla.org/ru/docs/Web/HTML/Element), либо на конкрентый элемент, например <colgroup>.
- Аналогично, если вы пишете о CSS, вы можете сослаться как на наш справочник по CSS (большой индекс: https://developer.mozilla.org/ru/docs/Web/CSS/Reference), так и на конкретное свойство, о котором вы пишете, например list-style-type.

Но на самом деле, вы должны ссылаться на наиболее подходящую к вашему содержимому и для ваших пользователей страницу. Не забывайте, что важны ваши читатели, а не ссылки на нас.

Как создать хорошую ссылку?

Создание ссылок — дело тривиальное, но создание хороших ссылок — это нечто более сложное. Существует несколько способов создать ссылки:

Ссылки в тексте

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

… с помощью API IndexedDB данные можно хранить в локальной базе данных…

Такие ссылки очень ценны как для пользователя, который получает информацию, доступную в один щелчок мыши, так и для MDN, так как пользователям, пришедших к нам по точному контексту, скорее всего понравится наше содержимое. Поскольку наша миссия состоит в том, чтобы читатели нашли то, что им нужно, как можно быстрее, это определённо очень хорошая вещь.

Что не надо делать при проставлении ссылок в тексте

Проставление ссылок в тексте действительно очень клёво и полезно, но есть несколько вещей, которых нужно избегать:

Не ставьте слишком много ссылок. Не ставьте ссылки на каждое слово или почти каждое слово. Это раздражает. Тщательно выбирайте и ставьте ссылку только на основные понятия в вашем тексте, либо специально выбирайте ссылки на страницы о понятиях, о которых читатель ещё, вероятно, не знает.
Не ссылайтесь на один и тот же термин снова и снова. Если вы пишете об анимациях на CSS, не нужно ставить ссылку на каждое вхождение слова «анимация» на свойство CSS animation. Если читатели не знают понятие, они скорее щёлкнут на первое вхождение для получения релевантной информации. Далее по тексту вы можете безопасно предполагать, что читатель уже знает о понятии, либо ещё до чтения страницы, либо сходив по предыдущей ссылке. Время от времени вы можете вставлять ссылку на термин (максимум одну на несколько абзацев), так что если читателю позже нужно будет перейти по ссылке, ему не надо будет долго прокручивать страницу.
Будьте внимательны, проставляя ссылки на форумах и в комментариях к блогам. Предоставление релевантных ссылок на постоянные ресурсы по конкретному вопросу или проблеме — это здорово и всячески приветствуется. Блуждание по сети и заваливание ссылками на MDN наоборот, не ценится: и владельцы сайтов, и читатели быстро признают в вас спамера и репутация MDN будет подмочена. Мы прилагаем гиганские усилия для построения ценного ресурса и у нас нет никакого желания, чтобы они разрушались таким поведением, поэтому, пожалуйста, размещайте только релевантные ссылки в соответствующее время.

Добавление баннера или изображения на ваш сайт

Другим способом сослаться на MDN является добавление изображения со ссылкой вне основного текста страницы, например, в боковую панель. Он имеет другое значение: тогда как проставление ссылок в тексте является способом предоставления дополнительной информации вашим пользователям, добавление изображения со ссылкой в боковую панель — это способ показать вашу поддержку проекту MDN или способ продвинуть MDN. Также это способ предложения MDN в качестве единого ресурса со всей информацией.

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

Автоматическое проставление ссылок на MDN из WordPress

Мы создали плагин WordPress, который автоматически проставляет ссылки на выбранные термины в записях вашего блога на соответствующие страницы MDN. Делает он это разумно, в соответствии с рекомендациями, изложенными выше и может быть большим подспорьем для блоггеров, пишущих о концепциях веба. Взгляните на него, и попробуйте установить, если вы думаете, что он может быть полезен.

Большое спасибо вам за вашу поддержку!