Добавляет доку про атрибут rel
#5536
Conversation
|
@solarrust |
|
Привет! Большая получилась дока, подробная. Это очень хорошо =) Следующим подходом планирую немного упростить структуру, уменьшить количество уровней заголовков. Призову ещё @TatianaFokina и @skorobaeus на помощь. Вместе сделаем прекрасную доку =) |
Превью контента из 4332ba9 опубликовано. |
|
Привет! Какие еще улучшения можно внести? В спецификации WHATWG есть условный блок "other" — возможно, его стоит добавить. Примеры сейчас взяты из WHATWG, и, возможно, этого достаточно для понимания. Но стоит ли добавить ссылки на сайты, где это используется на практике, чтобы увидеть, как это работает в реальных условиях? |
| <link rel="stylesheet" href="styles.css"> | ||
| ``` | ||
|
|
||
| ## Зачем нужен атрибут `rel`? |
There was a problem hiding this comment.
Кажется, можно убрать заголовок «Зачем нужен атрибут rel?», а список причин перенести в «Кратко» с уточнением, что вот для чего нужен атрибут. Можно даже ненумерованным списком делать, тут не важна последовательность действий.
|
|
||
| Используется с тегами [`<link>`](/html/link/), [`<a>`](/html/a/) и [`<area>`](/html/area/). | ||
|
|
||
| #### С тегом `<link>` для альтернативных стилей |
There was a problem hiding this comment.
Предлагаю убрать все заголовки четвёртого уровня подразделе «rel="alternate"». Ты уже в тексте упоминаешь, что за кейсы описываешь.
| <a href="document.pdf" rel="alternate" type="application/pdf">Скачать PDF</a> | ||
| ``` | ||
|
|
||
| ### `rel="author"` |
There was a problem hiding this comment.
Тут тоже можно остановится на подразделе «rel="author"», а все подзаголовки в нём убрать.
|
|
||
| > Ссылка на автора может часто представлять собой адрес электронной почты, начинающийся с `mailto:`. | ||
|
|
||
| ### `rel="bookmark"` |
There was a problem hiding this comment.
Аналогично и с подразделом «rel="bookmark"»: заголовки четвёртого уровня можно безболезненно удалить.
|
|
||
| Атрибут `rel="canonical"` используется с тегом `<link>`. | ||
|
|
||
| #### Для указания канонического URL |
There was a problem hiding this comment.
«Для указания канонического URL» предлагаю удалить.
|
|
||
| Атрибут `rel="canonical"` указывает, что URL, указанный в атрибуте `href`, является предпочтительным URL для текущего документа. Это помогает поисковым системам уменьшить количество дублирующегося контента, как описано в стандарте RFC 6596. | ||
|
|
||
| #### Основные моменты |
There was a problem hiding this comment.
Этот заголовок лучше сделать простым параграфом. Либо так и оставить про основные моменты. либо расширить до чего-то вроде: «Основные моменты работы с каноническим URL».
| <link rel="canonical" href="https://example.com/preferred-url"> | ||
| ``` | ||
|
|
||
| #### Рекомендации из стандарта |
There was a problem hiding this comment.
«Рекомендации из стандарта» тоже хорошо бы сделать параграфом и уточнить, что это рекомендации по работе с каноническим URL.
|
|
||
| Что делает dns-prefetch? Он сигнализирует браузеру, что ресурсы на указанном домене, скорее всего, понадобятся, и заранее разрешает их адреса, тем самым уменьшая задержки при загрузке. Путем предварительного разрешения DNS, браузер сокращает время ожидания для последующих запросов на загрузку ресурсов, что улучшает производительность. | ||
|
|
||
| #### Когда браузер обрабатывает dns-prefetch |
There was a problem hiding this comment.
«Когда браузер обрабатывает dns-prefetch» лучше сделать параграфом.
| 1. Когда элемент `<link>` уже подключен к контексту просмотра. | ||
| 1. Когда атрибут `href` изменяется у элемента `<link>`. | ||
|
|
||
| #### Алгоритм обработки браузером |
There was a problem hiding this comment.
«Алгоритм обработки браузером» лучше сделать параграфом.
|
|
||
| Этот элемент говорит браузеру заранее разрешить DNS для _example.com_, что может ускорить загрузку любых ресурсов, которые могут быть запрошены с этого домена. | ||
|
|
||
| ### `rel="expect"` |
There was a problem hiding this comment.
Аналогично и дальше. Принцип такой: если подпункт получается очень кратким, скорее всего что-то пошло не так. Либо это случай, когда лучше всё оставить обычным текстом, либо подзаголовок можно безболезненно удалить.
Описание
Closes #
Чек-лист
/css/color/,/tools/json/,/tools/gulp/#kak-ponyat)images/example.png,demos/example/,../demos/example/)