AGENTS.md — content/

Scope and inheritance

Applies to: content/. Inherits repository-wide guidance from /AGENTS.md. This file defines only local differences for редактирования контента.

What lives here

content/
├── _index.md                # Главная: требует hero-параметры (см. ниже)
├── <section>/_index.md      # Landing раздела (news, statistics, guides, policies, about)
└── <section>/<slug>/        # Leaf bundle статьи
    ├── index.md
    └── ...вложения (изображения, .xlsx и т.п.) рядом

Local boundaries and invariants

• Весь контент — на русском. Текст интерфейса тоже на русском.
• Section landing = _index.md; статья = leaf bundle с index.md + вложениями рядом (не _index.md внутри статьи).
• Front matter раздела (_index.md): обязательны title, description, weight, icon.
• icon ∈ {news, chart, guide, document, info}. Значение рендерится в layouts/partials/section-card.html; неизвестное значение молча даёт иконку info.
• Разделы автособираются и сортируются по weight (главная страница + меню hugo.yaml).
• Главная (content/_index.md) требует hero-параметры: heroPrimaryLabel/heroPrimaryURL, heroSecondaryLabel/heroSecondaryURL — используются в layouts/home.html.

Safe change rules

• Новый раздел: создайте content/<section>/_index.md и добавьте пункт в menus.main в hugo.yaml, если он нужен в навигации.
• Не задавайте icon вне enum — иконка будет неверной без ошибки сборки.
• Даты: lastmod показывается пользователям (Обновлено ...). Git-даты не используются (enableGitInfo: false), обновляйте date/lastmod осознанно.
• Миграция BookStack: задавайте стабильный url и список прежних адресов в aliases.

Validation

make check собирает сайт и проверяет index.html/404.html. Перед добавлением вложений убедитесь, что статья — leaf bundle (папка с index.md), а не branch (_index.md).