<aside> 💡 Это фундаментальный документ, по которому мы собираем все наши инструкции. Внимательно его изучи, добавь себе в избранное (звёздочка в правом верхнем углу) и регулярно сверяй свои инструкции на соответствие этим правилам

</aside>

Ключевое

Структура страницы

• Заголовок страницы. Контент и заголовок должны соответствовать друг другу
• Оглавление. Больше одного заголовка - обязательно оглавление
• Зачем нужна эта инструкция. Можно оставить только для страниц, которые саботируют
• Контент

Выделения ключевых моментов в тексте

Используем минимальный набор инструментов для выделения: жирный и /Callout

Подчёркивания, курсив, /Quote не используем - если будет сильно много способов выделения текста, читатель запутается в чём разница между жирным, курсивом, подчёркнутым, выделенным цветом и т.д.

<aside> 💡 Это /Callout — он классный, его можно.

</aside>

Это /Quote, его не юзаем

Заботливый жирный

Заботливо выделяем жирным ****ключевые моменты в каждом абзаце, чтобы глазу читателя было проще ориентироваться в текстах, считывать их по диагонали:

• Пример комментария
• Ещё пример комментария и два варианта, что выделить жирным

Заботливые ссылки

Все ссылки мы не вставляем в чистом виде, а вшиваем в пояснительный текст. Например:

• Так не надо: https://www.youtube.com/watch?v=B8If3PmUHLI
• А вот так надо: Ссылка на видео двенадцатичасового костра

Чтобы добавить ссылку, выдели текст и в появившейся плашке для редактирования текста нажми Link

Или выдели текст и нажми сочетание клавиш command+K/ctrl+K