Правила wiki SKIF.PRO

Wialon-style · превью под обсуждение · 2026-06-11 → Гайд для авторов

Что меняется

Мы отказываемся от типизации статей A/B/C/D и переходим на модель Wialon: одна статья = одна сущность или один аспект сущности. Концепция и инструкция могут сосуществовать в одном файле.

Декомпозиция как у Wialon — file-per-aspect. Каждая сущность раскладывается на 4–5 файлов: Создание + Свойства + Работа с + Применение (+ Группы опционально) + overview-страница сущности. Редактирование и Удаление — H2-секции внутри «Создание», не отдельные файлы.

Frontmatter — опционален. Аудитория, секция и сущность выводятся из пути файла и заголовка. YAML-блок указывается только когда нужно переопределить дефолт.

Универсальный словарь H2-секций (фиксированный порядок при наличии): Свойства → Создание → Редактирование → Удаление → Работа с → Группы → Применение → Ограничения → Смотрите также

Уровни: 1 блокирует мерж, 2 важная ошибка (warning), 3 рекомендация.

1. Заголовок статьи

Wialon никогда не использует вопросительные заголовки. Заголовок — отглагольное существительное («Создание геозон») или существительное-сущность («Объект на карте»).

TITLE-01 Уровень 1

Заголовок не начинается с «Как», «Что такое», «Почему», «Зачем»

Что проверяет
H1 статьи не начинается с вопросительной/«как»-конструкции и не заканчивается знаком вопроса.
На что влияет
Согласованность навигации: заголовки в боковом меню читаются как названия сущностей и действий, а не как FAQ-вопросы.
Зачем
Wialon показал, что отглагольные заголовки лучше масштабируются: длинные списки «Создание / Редактирование / Удаление / Свойства» легче сканировать, чем «Как создать… / Как редактировать… / Как удалить…». Также короче в навигации.

Пример Wialon

creating-geofences →
Правильно (Wialon)
# Создание геозон
Запрещено
# Как создать геозону
TITLE-02 Уровень 2

Действие в заголовке — отглагольное существительное, не инфинитив

Что проверяет
Если в H1 есть действие, оно выражено существительным («Создание», «Настройка», «Удаление»), а не глаголом в инфинитиве («Создать», «Настроить»).
На что влияет
Единообразие пары «существительное + сущность» во всей wiki.
Зачем
Глаголы в инфинитиве звучат как кнопка («Создать») и не подходят для названия статьи. Wialon строго придерживается отглагольных существительных.

Пример Wialon

Правильно
# Работа с геозонами
Не пишем
# Работать с геозонами

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

Каждая статья начинается с лид-абзаца (1–3 предложения, часто про права доступа или предусловия) и содержит чётко сгруппированные H2-секции.

STRUCT-01 Уровень 1

Ровно один H1 на самом верху статьи

Что проверяет
В статье есть ровно один заголовок первого уровня (#), он расположен в начале файла.
На что влияет
Корректное оглавление справа на странице рендера; индексирование статьи; SEO.
Зачем
Множественные H1 ломают навигацию и оглавление. Wialon всегда даёт ровно один H1 на страницу.
STRUCT-02 Уровень 1

H2-секция не может быть пустой

Что проверяет
Каждая H2-секция содержит хотя бы один непустой абзац, список или таблицу до следующего H2.
На что влияет
Запрет «скелетов»: статья с заголовками без тела не публикуется.
Зачем
Без этого правила автор создаст заготовку со всеми H2 из словаря и зальёт её в main. Wialon никогда не публикует stub-секции.
STRUCT-03 Уровень 3

На content-странице минимум 2 H2-секции

Что проверяет
Не-хабовая статья содержит ≥2 H2-заголовков (минимум для оглавления справа).
На что влияет
Узкие статьи на 1 H2 не имеют навигации и плохо ищутся.
Зачем
Если статья получилась на 1 H2 — это сигнал, что её надо объединить с соседней или дополнить.
STRUCT-12 Уровень 2

Заголовки не глубже H3

Что проверяет
В теле статьи используются только H2 и H3 (внутри H1).
На что влияет
Глубокая вложенность H4–H6 делает оглавление нечитаемым.
Зачем
Wialon на content-страницах не уходит глубже H3. Если требуется H4 — это сигнал, что подсекцию пора выделить в отдельную статью.
LEAD-01 Уровень 2

Лид-абзац между H1 и первым H2 (1–3 предложения)

Что проверяет
Между H1 и первым H2 есть хотя бы одно предложение текста. Пустой переход H1 → H2 запрещён. Не применяется к хабам.
На что влияет
Контекст для читателя, прежде чем он провалится в детали. Подсказка для AI-помощников при извлечении фрагментов.
Зачем
Wialon в лиде часто пишет требования к правам доступа или короткую формулировку «для чего» — это даёт читателю быструю опору.

Пример Wialon (creating-geofences)

Для создания геозон необходимо право доступа Создание, редактирование и удаление геозон на ресурс.
LEAD-02 Уровень 3

Лид-абзац описывает права/предусловия, не «о чём статья»

Что проверяет
В лиде action-страницы (Создание / Редактирование / Удаление / Работа с) — конкретные требования: какие права доступа нужны, что должно быть готово, какие предусловия. Запрещены формулировки «эта статья описывает», «в данном руководстве», «прочитайте внимательно».
На что влияет
Читатель понимает за 5 секунд, сможет ли он вообще выполнить инструкцию или нет.
Зачем
Wialon делает это во ВСЕХ action-страницах: «Для создания X необходимо право Y». Метакомментарии («эта статья описывает») — нулевая ценность.

Сравнение

Правильно (Wialon-стиль)
Для создания геозон необходимо право доступа Создание, редактирование и удаление геозон на ресурс.
Запрещено
В этой статье описано, как создать геозону в платформе SKIF.PRO. Прочитайте внимательно перед началом работы.

3. Шаги и действия

Action-секции («Создание», «Редактирование», «Удаление») оформляются нумерованным списком с глаголами повелительного наклонения.

STEPS-01 Уровень 1

В action-секциях шаги — нумерованный список (1. 2. 3.)

Что проверяет
Шаги в секциях «Создание / Редактирование / Удаление / Этапы …» оформлены как ordered list, не как маркированный.
На что влияет
Порядок шагов сохраняется при печати и копировании. Читатель понимает, что последовательность важна.
Зачем
Wialon на странице «Создание геозон» использует 5 нумерованных списков подряд для разных под-сценариев. Это явно сигнализирует «здесь надо делать по порядку».

Пример Wialon (creating-geofences → Этапы создания геозон)

1. Нажмите на Создать на вкладке Геозоны. 2. Выберите тип геозоны: полигон, линия или круг. 3. Нанесите геозону на карту.
STEPS-02 Уровень 2

Каждый шаг начинается с глагола повелительного наклонения

Что проверяет
Первое слово каждого пункта нумерованного списка в action-секции — глагол в повелительном наклонении (Нажмите, Откройте, Выберите, Введите).
На что влияет
Однородность инструкций; устранение «можно нажать», «потом нажимается» и пассивных конструкций.
Зачем
Wialon использует исключительно повелительное наклонение в шагах. Это короче и не оставляет двусмысленности «кто это делает».
STEPS-03 Уровень 2

UI-элементы в шагах выделены жирным

Что проверяет
Названия кнопок, вкладок, полей формы, разделов меню в тексте шага обёрнуты в **жирный**.
На что влияет
Сканируемость: глаза находят кнопку «Создать» быстрее, чем «Создать».
Зачем
Wialon выделяет жирным каждое название элемента UI («Нажмите на Создать на вкладке Геозоны»). Это становится визуальной картой.
STEPS-06 Уровень 3

Варианты реализации действия — отдельные H3 со своими шагами

Что проверяет
Если у действия несколько вариантов реализации (типы геометрии, способы доступа к функции, альтернативные интерфейсы), каждый вариант — собственная H3-подсекция со своим набором нумерованных шагов. НЕ объединяй варианты в один список с условными ветками «если..., то...».
На что влияет
Чёткое разделение сценариев; читатель находит свой вариант и идёт по нему без отвлечения.
Зачем
Wialon в «Создание геозон» / «Нанесение геозоны на карту» даёт 4 H3-подсекции: Полигон, Линия, Круг, Действия с точками. У каждой свой набор шагов.

Пример Wialon

## Нанесение геозоны на карту ### Полигон 1. Сделайте двойной щелчок по карте, чтобы поставить первую точку. 2. Поставьте вторую и третью точки. 3. Поставьте следующие точки для нужной формы. ### Линия 1. Сделайте двойной щелчок по карте. 2. Поставьте следующие точки.

4. Параметры и свойства

Любая длинная форма или набор опций оформляется таблицей с фиксированными колонками «Параметр | Описание».

PROPS-01 Уровень 1

Свойства/параметры — таблица «Параметр | Описание»

Что проверяет
Секция «Свойства» или «Параметры» оформлена как Markdown-таблица с колонками не менее «Параметр» и «Описание». Опциональные колонки: «По умолчанию», «Допустимые значения».
На что влияет
Сканируемость; AI-помощник может извлечь нужный параметр одной строкой; перевод на другие языки выравнивается по таблице.
Зачем
Wialon на странице «Объект на карте» использует 3 таблицы «Опция | Описание» вместо вложенных списков. На «Применение геозон» — таблица «Вкладка | Применение». Это становится универсальным паттерном.

Пример Wialon (unit-on-the-map)

unit-on-the-map →
| Опция | Описание | |--------------|-----------------------------------------| | Иконка | Картинка объекта в списке мониторинга. | | Курс | Стрелка, показывающая направление… | | Сигнал GPS | Индикатор качества спутникового сигнала. |
PROPS-02 Уровень 3

Названия параметров в таблице совпадают с UI 1:1

Что проверяет
Текст в колонке «Параметр» дословно совпадает с подписью элемента в интерфейсе (с учётом регистра).
На что влияет
Поиск по wiki: пользователь ищет точное название из UI и находит статью.
Зачем
Wialon строго придерживается этого правила: «Сигнал GPS» в UI = «Сигнал GPS» в таблице, не «GPS-сигнал».

5. Декомпозиция и универсальные секции

Каждая сущность разбивается на 4–5 файлов (file-per-aspect, как у Wialon). Секции внутри файлов — из универсального словаря в фиксированном порядке.

DECOMP-01 Уровень 1

Сущность раскладывается на отдельные aspect-файлы

Что проверяет
Для каждой основной сущности (объект, геозона, отчёт, уведомление, поле, операция, регистрация) в дереве wiki существуют отдельные .md файлы для аспектов:
• <Сущность>.md — overview
• <Сущность>/Создание <сущности>.md — только создание + детали реализации
• <Сущность>/Свойства <сущности>.md — справочник полей формы
• <Сущность>/Работа с <сущностью>.md — список, фильтры, редактирование, удаление
• <Сущность>/Применение <сущности>.md (опционально)
• <Сущность>/Группы <сущности>.md (опционально)

Wialon-паттерн: «Редактирование» и «Удаление» — H2-секции внутри «Работа с» (НЕ внутри «Создание» и НЕ отдельные файлы), потому что это UI-операции над существующими сущностями. Максимум 1500 слов на файл.
На что влияет
Стабильные URL на аспект (саппорт может скинуть точную ссылку «Создание геозон» вместо «открой Геозоны и листай вниз»). Поиск попадает в нужный файл. Можно отдельно ревьюить и назначать ответственных по аспектам.
Зачем
Wialon именно так структурирован: «Геозоны» = 5 файлов (overview + 4 аспекта). Без декомпозиции получим мегастатьи на 5000 слов — формально всё ок, но не похоже на Wialon.

Пример Wialon — раскладка «Геозоны»

geofences.md ← overview (H1 + видео + краткое описание) geofences/creating-geofences.md ← Создание геозон geofences/managing-geofences.md ← Работа с геозонами geofences/using-geofences.md ← Применение геозон geofences/groups-of-geofences.md ← Группы геозон
ENTITY-02 Уровень 2

Overview-страница не дублирует содержимое aspect-файлов

Что проверяет
Overview-файл сущности (например, Геозоны.md) содержит:
• краткое описание сущности (1–3 абзаца),
• ссылки на все aspect-файлы с однострочным описанием каждого,
• опционально — видео или скриншот общего вида.
НЕ содержит таблиц параметров, нумерованных шагов или подробных сценариев — это всё в aspect-файлах.

Overview обязателен, если у сущности ≥2 aspect-файлов. Если aspect один — overview не нужен.
На что влияет
Запрет «у нас три места, где описано одно и то же». Чёткое разделение точки входа и деталей.
Зачем
Wialon overview-страницы тонкие (видео + описание + меню). Если в overview начинают переписывать содержимое aspect-страниц — это путь к мегафайлам и расходящимся версиям.
SECT-02 Уровень 2

H2 из словаря включает имя сущности

Что проверяет
Если H2 — слово из универсального словаря, оно используется в составе «Создание геозон», а не голое «Создание». Исключение: внутри файла, где сущность очевидна из H1 (например, файл «Создание геозон.md» может иметь H2 «Этапы создания геозон»).
На что влияет
Самодостаточность секций. Если читатель попал на якорь H2 из поиска, он сразу видит, о какой сущности речь.
Зачем
Wialon никогда не пишет голое «Создание». Всегда полная форма с именем сущности.

Сравнение

Правильно
## Создание геозон
## Работа с геозонами
## Применение геозон
Запрещено
## Создание
## Работа с
## Применение
SECT-04 Уровень 2

Фиксированный порядок H2-секций

Что проверяет
Если в статье несколько H2 из универсального словаря, они идут в порядке:
Свойства → Создание → Редактирование → Удаление → Работа с → Группы → Применение → Ограничения → Смотрите также.

Свободные (не из словаря) H2 могут располагаться где угодно.
На что влияет
Единый порядок чтения по всем статьям. Wialon строго придерживается этого порядка.
Зачем
Без правила автор поставит «Применение» первым «потому что важно». Разнобой порядка ломает узнаваемость структуры.
SECT-01 Уровень 3

H2-секции — из универсального словаря

Что проверяет
H2 заголовки по возможности выбираются из словаря: Свойства, Создание, Редактирование, Удаление, Работа с, Группы, Применение, Ограничения, Смотрите также. Свободные H2 разрешены.
На что влияет
Узнаваемость структуры между разными статьями; меньше когнитивной нагрузки.
Зачем
На страницах геозон Wialon повторяется паттерн «Свойства / Создание / Работа с / Группы / Применение». На объектах — то же. Читатель, изучив одну сущность, знает, где искать в другой.
ENTITY-01 Уровень 3

Overview-страница содержит ссылки на все aspect-файлы

Что проверяет
Если H1 — существительное-сущность («Геозоны»), overview-страница содержит маркированный список ссылок на все её aspect-файлы.
На что влияет
Полнота навигации: с overview можно попасть в любой аспект.
Зачем
Wialon в overview всегда даёт список из 4–5 ссылок на aspect-страницы.
HIER-01 Уровень 2

Глубина wiki — до 5 уровней

Что проверяет
Максимальная глубина — 5 уровней папок. Каталог с более чем 5 статьями содержит индексную hub-страницу.
На что влияет
Поддерживаемость навигации; читатель не теряется в плоских списках по 20+ статей.
Зачем
Wialon достигает глубины 4–5 уровней (например: monitoring-system / geofences / creating-geofences), и у каждого крупного раздела есть отдельный хаб.

6. Скриншоты

Wialon ставит 0–9 скриншотов на страницу (типично 1–6); максимум 9 — на task-странице «Создание геозон». На management-страницах он дополнительно использует inline-иконки UI — мелкие PNG прямо в строке текста рядом с именем кнопки. Это два разных приёма, не путать. Скриншот без поясняющего текста запрещён.

SCREEN-01 Уровень 3

На странице сущности — скриншот общего вида UI

Что проверяет
В начале content-страницы (после лид-абзаца) или после первого шага есть хотя бы один скриншот, показывающий общий вид UI описываемой сущности.
На что влияет
Быстрая ориентация: читатель сразу понимает, в каком экране он окажется.
Зачем
В «Работа с геозонами» Wialon ставит 2 крупных скриншота (общий вид списка и всплывающая подсказка), а 11 кнопок-действий показывает inline-иконками внутри текста. Скриншот общего вида UI даёт пользователю якорь — он понимает, в каком экране находится, и не описывает кнопку словами «я не вижу ту».
CONT-12 Уровень 2

Скриншоты сопровождаются текстовым описанием

Что проверяет
Рядом с каждым скриншотом (в соседнем абзаце до или после) — текст, объясняющий, что на изображении и зачем оно тут. Формальная подпись курсивом — внутренняя норма SKIF (для скринридеров и индексации); Wialon её не использует, текст интегрирован в прозу.
На что влияет
Доступность (скринридеры); поиск по wiki; индексация в AI.
Зачем
Голый скриншот без пояснений не индексируется и недоступен пользователям с ограничениями. Wialon обрамляет каждое изображение поясняющим абзацем, мы добавляем сверху формальную подпись курсивом — это лишние 5 секунд автору, но выигрыш для поиска и доступности.
SCREEN-02 Уровень 3

Inline-иконки UI для кнопок и действий списка

Что проверяет
Когда в тексте упоминается кнопка панели инструментов или иконка-индикатор (типа геозоны, состояние связи), рядом с её именем стоит её PNG-иконка (≤3 КБ), вставленная как inline-глиф. Не путать со скриншотом — это отдельный мелкий ассет.
На что влияет
Скорость опознавания кнопки в реальном UI; уменьшение количества крупных скриншотов на странице.
Зачем
Wialon на странице «Работа с геозонами» использует 11 inline-иконок (Редактировать, Копировать, Удалить, типы геозон и т. д.) вместо того, чтобы сажать 11 крупных скриншотов. Это держит страницу компактной, а пользователь видит точный глиф, который ищет в интерфейсе.
SCREEN-03 Уровень 3

В action-странице — минимум 3 скриншота

Что проверяет
В action-страницах (Создание / Работа с) рекомендуется ≥3 скриншотов: общий вид формы (после первого шага), результат успешного выполнения, ключевая промежуточная стадия (если процесс многоэтапный).
На что влияет
Снижение нагрузки на саппорт: пользователь видит, что должно быть в каждый момент, и не пишет «у меня не так».
Зачем
Wialon на странице creating-geofences использует 9 скриншотов: форма, каждый тип геозоны на карте, форма свойств, результат сохранения и т.д. Это много, но именно так создаётся «без вопросов».

8. Язык

Аудитория R1 (диспетчеры, логисты) — простой язык, активный залог, UI жирным. Аудитория R2 (интеграторы) — допускаются термины и типы данных.

LANG-01 Уровень 2

Для R1: нет пассивного залога в инструкциях

Что проверяет
В шагах и описаниях нет конструкций «нажимается», «открывается», «осуществляется». Только активный залог.
На что влияет
Ясность: кто кому делает.
Зачем
Пассив создаёт когнитивное усилие. Активный залог — стандарт всех современных help-центров, включая Wialon.
LANG-02 Уровень 2

Для R1: нет технического жаргона без объяснения

Что проверяет
Технические термины (API, webhook, MQTT) или объясняются при первом упоминании, или заменяются.
На что влияет
Понимание у не-технических читателей.
Зачем
Wialon разделяет user-guide и developers — но если у нас единая wiki, мы не можем рассчитывать на технический контекст читателя.
LANG-03 Уровень 2

Названия элементов UI выделены жирным

Что проверяет
В тексте за пределами таблиц параметров названия кнопок, вкладок, полей формы — **жирным**.
На что влияет
Сканируемость; читатель находит нужный элемент глазами.
Зачем
Wialon выделяет каждое название UI. Дублирует STEPS-03, но действует и вне шагов.
LANG-04 Уровень 2

Нет неопределённых местоимений без антецедента

Что проверяет
В тексте нет «это», «данный», «такой», «он» без явного указания, на что они ссылаются.
На что влияет
Самодостаточность секций; AI-помощник может извлечь любой абзац и он остаётся понятным.
Зачем
Wialon заменяет «он» на конкретное имя сущности («объект», «геозона»). Это снижает количество ошибок понимания.

9. Самодостаточность для AI и поиска

Статья должна корректно читаться при извлечении произвольной секции.

AI-01 Уровень 3

Каждая секция самодостаточна при фрагментарном извлечении

Что проверяет
Содержимое каждой H2-секции читается изолированно: не отсылает к «выше» / «ранее».
На что влияет
Качество AI-ассистентов; пользователь, попавший на якорь H2 из поиска, получает связное содержимое.
Зачем
Wialon встроил в свой help-центр AI Assistant, и оптимизация статей под фрагментарное чтение — это их явная задача.
AI-03 Уровень 3

Ключевые термины присутствуют в тексте, не только в заголовке

Что проверяет
Каноничный термин сущности упомянут в первом абзаце и далее по тексту, не только в H1.
На что влияет
Полнотекстовый поиск находит статью даже когда H1 не парсится.
Зачем
Wialon на «Геозоны» в первом предложении использует слово «геозона» 2–3 раза с разными окончаниями.
AI-04 Уровень 3

Нет ссылок «как описано выше» или «см. предыдущий раздел»

Что проверяет
В тексте нет относительных навигационных ссылок без anchor-имени секции.
На что влияет
Перенос контента между статьями не ломает ссылки; AI-извлечение не теряет контекст.
Зачем
«Выше» теряет смысл в поиске, в RSS, в синдикации. Wialon вместо «выше» пишет имя секции с гиперссылкой.

10. Метаданные (минимум)

Frontmatter — опционален. Большинство статей не имеют YAML-блока вообще. Появляется только при необходимости переопределить дефолт.

META-01 Уровень 1

Frontmatter (если есть) — валидный YAML

Что проверяет
Если в начале файла есть блок ---, он парсится как YAML без ошибок.
На что влияет
Сборка статической wiki; иначе пайплайн падает.
Зачем
Битый YAML ломает рендер. Лучше блокировать на мерже.
META-02 Уровень 1

Поле audience (если указано) — R1 или R2

Что проверяет
Если автор переопределяет audience, значение — строго «R1» или «R2».
На что влияет
Применимость языковых правил LANG-01..LANG-03.
Зачем
Дефолт выводится из пути файла. Override нужен только для смешанных подразделов.
META-03 Уровень 1

Запрещённые legacy-поля не используются

Что проверяет
В frontmatter нет полей type, source, version.
На что влияет
Чистота миграции: старая типизация полностью удалена.
Зачем
Иначе авторы продолжат заполнять старые поля по привычке.
Что выводится из пути файла автоматически
audience: R2 если путь начинается с API/, Протоколы/, Интеграции/, Оборудование/, Ресурсы компании/, Настройка платформы/ audience: R1 в остальных случаях section: из пути файла, например wiki/Объекты/Карточка/Создание.md → "Объекты/Карточка" entity: из H1 sections: из тела статьи (список H2) last_verified: стампится CI из git log owner: git log %ae (последний коммитер) или CODEOWNERS

11. Терминология

Каноничные термины из terminology.yaml. Запрещённые варианты блокируются.

TERM-01 Уровень 2

Используются каноничные термины из словаря

Что проверяет
В тексте отсутствуют запрещённые варианты (поле forbidden в terminology.yaml). Используется canonical или один из synonyms.
На что влияет
Терминологическая консистентность всей wiki.
Зачем
Wialon строго придерживается одного канонического термина для каждой сущности; смешение «прицеп» / «трейлер» / «agro-агрегат» путает читателя.
TERM-02 Уровень 2

Первое упоминание ключевого термина — с пояснением

Что проверяет
Для ключевых сущностей (объект, геозона, поле, операция) при первом упоминании в статье даётся короткое пояснение по правилу first_use.
На что влияет
Понятность статьи без необходимости открывать другие страницы.
Зачем
Если статья — точка входа из Google, читателю нужен контекст «что такое объект».
TERM-03 Уровень 2

Маппинг SKIF.PRO ↔ SKIF.AGRO объясняется явно

Что проверяет
Если статья упоминает связь между сущностями двух систем (геозона→поле, прицеп→агрегат), связь объясняется явно: «Прицеп в SKIF.PRO синхронизируется как агрегат в SKIF.AGRO», а не подразумевается.
На что влияет
Пересечение двух платформ — главный источник путаницы.
Зачем
Если читатель не знает маппинга, действия в одной системе кажутся ему не имеющими эффекта в другой.

12. Хаб-страницы (page_role: hub)

Хаб — индексная страница раздела с навигацией. К ней не применяются правила TITLE, STRUCT, STEPS, PROPS.

HUB-01 Уровень 1

Хаб содержит page_role: hub в frontmatter

Что проверяет
В YAML присутствует page_role: hub. Это единственный обязательный frontmatter в новой модели.
На что влияет
Чекер применяет к хабам отдельный набор правил, а не правила content-страниц.
Зачем
Без этого флага хаб без шагов и таблиц получил бы ложноположительные ошибки.
HUB-02 Уровень 1

Хаб не содержит legacy-полей

Что проверяет
В frontmatter хаба нет type, source, tested_by.
На что влияет
Чистота схемы.
Зачем
Хаб — не статья, его не тестируют, у него нет типа.
HUB-03 Уровень 1

Хаб содержит вводный абзац

Что проверяет
После H1 — 1–3 предложения о том, что входит в раздел.
На что влияет
Контекст для читателя перед списком ссылок.
Зачем
Голый список ссылок без описания не помогает выбрать нужную статью.
HUB-04 Уровень 2

Хаб содержит список подразделов со ссылками

Что проверяет
В теле хаба есть Markdown-список с ссылками на статьи раздела.
На что влияет
Навигация работает.
Зачем
Хаб без ссылок — это не хаб.
HUB-05 Уровень 2

Хаб не содержит шагов или таблиц параметров

Что проверяет
В хабе нет нумерованных списков-инструкций и таблиц «Параметр | Описание».
На что влияет
Разделение: хаб — навигация, не статья.
Зачем
Если в хаб начинает попадать content — это сигнал, что нужна полноценная статья.

SKIF.PRO Wiki Rules · Wialon-style edition · превью для согласования.
Источники: Геозоны · Создание геозон · Работа с геозонами · Применение геозон · Объект на карте