SEO

SEO (Search Engine Optimization) — это набор практик, которые помогают поисковикам находить, понимать и показывать ваши страницы пользователям. Цель простая: когда кто-то ищет «гайд по X» или «документация Y», ваша страница должна оказаться в выдаче.

Что нужно поисковику

Чтобы Google, Bing или Yandex проиндексировал вашу страницу, ему нужны три вещи:

  1. Найти URL. Через ссылку с другого сайта, через ваш sitemap.xml, через robots.txt — путей много, но без них бот не знает что страница существует.

  2. Получить осмысленный HTML. В современных SPA-приложениях контент часто грузится JavaScript'ом — для бота это пустая страница. Поэтому поисковики получают пред-рендеренный HTML: заголовок, описание, текст уже в первом ответе сервера.

  3. Понять структуру. Тег <title>, <meta description>, заголовки <h1>-<h3>, ссылки между страницами. Чем чище структура — тем точнее ранжирование.

Социальные превью — это тоже SEO

Когда вы делитесь ссылкой в Slack, Telegram или Twitter, появляется карточка с картинкой, заголовком и описанием. Это работает через Open Graph теги (og:title, og:description, og:image) в <head> страницы — те же боты, тот же механизм, только без поиска.

Главное правило

Контент важнее техники. Идеальные мета-теги не помогут странице с пустым телом. Сначала пишите хорошую документацию, потом думайте о том, как её правильно подать — с осмысленным заголовком, кратким описанием и одним выразительным изображением.