fix: accessibility docs #3453
Open
fix: accessibility docs #3453
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Привет! Спасибо за PR. Посмотрим в ближайшее время. |
|
Согласен с формулировкой насчёт только одного Есть оговорки насчёт |
sashachabin
reviewed
Jun 26, 2024
| 5. Для разметки областей страницы используйте теги `<header>`, `<main>`, `<article>`, `<nav>`, `<section>`, `<footer>`. | ||
| В отличии от тега `<h1>` элемент `<header>` можно использовать несколько раз на странице, например, для заголовка модального окна. Так же, несколько раз можно использовать `<footer>`, `<article>`, `<section>`, `<main>`. | ||
| 5. Для разметки областей страницы используйте теги `<main>`, `<header>`, `<footer>`, `<nav>`, `<aside>`, `<section>`, `<article>`. | ||
| Как и ранее рассмотренный тег `<h1>`, тег `<main>` можно использовать только один раз на странице, остальные — несколько раз (например, `<header>` можно использовать для заголовков разных модальных окон). |
There was a problem hiding this comment.
Предлагаю убрать «как и ранее рассмотренный» — само упоминание неплохое, но лучше не создавать лишнюю связность в тексте
There was a problem hiding this comment.
Предлагаю для точности добавить ссылку на whatwg:
Подобно тегу `<h1>`, тег `<main>` можно использовать на странице только один раз ([кроме исключений](https://html.spec.whatwg.org/multipage/grouping-content.html#the-main-element:~:text=A%20document%20must%20not%20have%20more%20than%20one))
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Проблема
<main>в документации о доступности;Решение
Исправление информации и опечаток.
Ссылки
Чек-лист перед запросом ревью
Добавлены тесты на все изменения
⬜ unit-тесты для логики
⬜ скриншоты для верстки и кросс-браузерности
✅ нерелевантно
Добавлена (обновлена) документация
⬜ styleguidist для пропов и примеров использования компонентов
⬜ jsdoc для утилит и хелперов
⬜ комментарии для неочевидных мест в коде
✅ прочие инструкции (
README.md,contributing.mdи др.)⬜ нерелевантно
Изменения корректно типизированы
⬜ без использования
any(см. PR2856)✅ нерелевантно
Прочее
✅ все тесты и линтеры на CI проходят
✅ в коде нет лишних изменений
✅ заголовок PR кратко и доступно отражает суть изменений (он попадет в changelog)