Справочные центры и версионирование доков: защита от старых v1/v2 версий
Открытая индексация устаревших v1, v2 и v3 версий документации на пяти языках кормит разработчиков и LLM устаревшими примерами кода.
Дмитрий К., Technical SEO Lead · SEO Space
1. Почему старые версии v1/v2 обгоняют актуальные гайды
Исторические ссылки со Stack Overflow и GitHub годами ведут на `/docs/v1/auth/`. Если старые версии открыты к индексации, они размывают авторитет `/docs/auth/` и подсовывают устаревший API в ИИ-поисковики.
Держите актуальную документацию на вечном пути без номера версии, а архивные снапшоты (`v1`, `v2`) закрывайте `noindex, follow` с плашкой перехода к актуальной версии.
- Публикуйте текущую стабильную документацию по вечному пути `/docs/<topic>/`.
- Архивные версии оставляйте доступными по ссылке с `X-Robots-Tag: noindex, follow`.
- Не клонируйте непереведённые английские статьи внутрь `/ru/docs/` — ставьте прямую ссылку на оригинал.
2. Заголовок защиты архивных версий доков
Автоматизируйте выдачу `noindex` для всех версий ниже текущей стабильной.
Гарантируйте, что поиск и разработчики всегда попадают на актуальный синтаксис.
| Раздел доков | Политика индекса | UX и ИИ |
|---|---|---|
| /docs/без-версии/ | Index, Follow (основной) | Единый каноникал и актуальный код |
| /docs/v1-v2-архив/ | noindex, follow + баннер | Доступно для старых систем без мусора |
| Непереведённая статья | Прямая ссылка на /en/docs/ | Ноль англоязычных дублей |
if (docVersion !== CURRENT_STABLE_VERSION) {
res.setHeader('X-Robots-Tag', 'noindex, follow');
} Нужно проверить индексацию вашего проекта?
Пришлите домен: вручную проверим исходный HTML, логи обхода, дубли фильтров, canonical и карту сайта в течение 24 часов.