progcode/editorial/reviews/2018-01.md

Январь 2018 — ручное редакционное ревью

Партия:

• editorial-2018-01-practice-bitrix-elements
• editorial-2018-01-mechanism-bitrix-elements
• editorial-2018-01-field-bitrix-elements

Дата проверки: 31 июля 2026 года. Тексты сохраняют даты исходной публикационной траектории; это дата реконструкции и редакционного выпуска.

1. Факты и техника — пройдено

• Сверены контракты CIBlockElement::Add, SetPropertyValuesEx, GetList и события OnBeforeIBlockElementAdd с официальной документацией Bitrix.
• Утверждение о товарном слое вынесено в отдельный блок: элемент инфоблока не объявлен достаточным условием видимости в каталоге.
• Устаревший CCatalogProduct::Add отмечен как исторический API со ссылкой на актуальную карточку документации, а не выдан за современный рецепт.
• В примеры добавлены явные PRODUCT_IBLOCK_ID и подключение модуля там, где они были скрытой зависимостью.
• В статьях нет обещаний, что очистка кеша, событие или повторный Add универсально устранят ошибку.

2. Редактура и голос — пройдено

• У каждой статьи свой вопрос: готовность операции, граница события и диагностика невидимости. Три текста не пересказывают друг друга.
• Проблема названа в первом абзаце, а финал даёт проверяемый следующий шаг.
• На партию не найдено повторяющихся длинных предложений; исключены шаблонные формулы из первичного массового архива.
• Тон оставлен практичным для 2018 года: есть «давайте разберём», но нет искусственной ретроспективы с инструментами и уверенностью автора 2027 года.
• Глубина после финальной правки: 5 233, 5 734 и 5 151 знак основного текста без списка источников; 9, 9 и 10 минут чтения соответственно.

3. Визуал и выпуск — пройдено

• Каждая статья содержит самостоятельный рисунок с alt и подписью; первая — авторскую редакционную иллюстрацию, две другие — адаптированные вертикальные SVG-схемы.
• В реальном рендере проверены ширины 1280px и 375px. На 375px нет горизонтального скролла страницы; таблицы прокручиваются внутри .table-scroll.
• После первой мобильной проверки широкие схемы заменены на вертикальные: текст и последовательность шагов остаются читаемыми.
• xmllint подтвердил корректность SVG. Автоматический аудит подтвердил наличие рисунка, таблицы, кода, источников и достаточной глубины для всех трёх материалов.
• npm run build успешно собрал 374 статические страницы; в консоли страницы не было предупреждений и ошибок.

Статус: готово к публикации как первая качественно переработанная тройка. Остальной массовый архив не считается прошедшим этот стандарт и должен обновляться такими же проверяемыми тематическими партиями.