Исправление терминологии: catalog описан как "контроллер" вместо "комплексный компонент" #66
Description
Описание проблемы
На странице документации по компонентам используется некорректная терминология: комплексный компонент catalog ошибочно назван "контроллером". В контексте Bitrix Framework эти термины обозначают разные архитектурные сущности.
Расположение
- URL: https://docs.1c-bitrix.ru/pages/framework/components.html
- Раздел: Компоненты (Components)
- Контекст: Описание структуры комплексного компонента
catalog
Текущий текст (некорректный)
> catalog — контроллер, в нем есть catalog.section
Ожидаемое исправление
> catalog — комплексный компонент, в нем есть catalog.section
Обоснование
Согласно документации по архитектуре компонентов:
| Термин | Определение | Пример |
|---|---|---|
| Комплексный компонент | Компонент высшего уровня, объединяющий простые компоненты, обрабатывающий ЧПУ (SEF) и маршрутизацию между ними | catalog, news, forum |
| Простой компонент | Компонент для вывода конкретных данных | catalog.section, catalog.element |
| Контроллер (D7) | Класс, наследующий Bitrix\Main\Engine\Controller, используется для обработки AJAX-запросов и API endpoint'ов |
Не путать с компонентами |
Использование термина "контроллер" для описания комплексного компонента catalog вводит разработчиков в заблуждение, так как:
- Контроллеры в D7 — это backend-классы нового ядра
- Комплексные компоненты — это устаревшая (legacy) концепция визуальных компонентов на старых классах
CBitrixComponent
Дополнительный контекст
Терминологическая путаница может затруднить понимание различий между:
- Компонентами старого ядра (
CBitrixComponent) - Контроллерами нового ядра D7 (
Bitrix\Main\Engine\Controller)
Рекомендуется использовать устоявшуюся терминологию из курса "Контент-менеджер" и "Разработчик Bitrix Framework".
Labels: documentation, bug, terminology, good first issue
Metadata
Metadata
Assignees
Labels
No labels