На странице https://docs.1c-bitrix.ru/pages/framework/components.html в разделе «Когда использовать компоненты» рекомендуется использовать «контроллер» для создания полнофункционального раздела (каталога товаров) вместо комплексного компонента.
Ссылка «контроллер» ведет на https://docs.1c-bitrix.ru/pages/framework/controllers.html, описывающую D7 Controller (\Bitrix\Main\Engine\Controller), предназначенный исключительно для AJAX/API (JsonResponse), а не для рендеринга HTML-страниц. Это вводит разработчиков в заблуждение, т.к. использование D7 Controller для вывода публичных страниц является architectural violation (нарушение MVC).
Прошу скорректировать документацию: либо заменить термин «контроллер» на корректный (указать простые компоненты + urlrewrite/D7 Router), либо привести пример корректного использования Controller для создания HTML-разделов, если такое использование действительно предполагается.