О проекте

BXWiki - независимый справочник для разработчиков на 1С-Битрикс. Проект не связан с компанией 1С-Битрикс и не заменяет официальную документацию, а дополняет её: там, где docs.1c-bitrix.ru и dev.1c-bitrix.ru описывают метод и его параметры, здесь показано, как этим пользуются на практике и что при этом обычно идёт не так.

Зачем появился этот справочник

Официальная документация отвечает на вопрос «что делает этот метод». На практике разработчику чаще нужен ответ на другие вопросы: какой из двух API выбрать - старый или D7, что вернёт вызов на самом деле и почему выборка ведёт себя не так, как ожидалось. Ответы на них обычно находят по крупицам - в чужом коде, на форумах, отладкой методом проб и ошибок. BXWiki собирает такие ответы в одном месте: по каждой теме - механика работы, разобранные примеры с показанным результатом, старый API рядом с D7 и частые ошибки в формате «симптом - причина».

Чем справочник отличается от официальной документации

Каждая статья построена по одной и той же схеме:

Как это работает - объяснение механики платформы, а не пересказ параметров метода.
Примеры с результатом - код с комментариями и тем, что он возвращает; там, где есть старый и новый API, оба показаны рядом.
Справочник API - таблица методов с сигнатурами и особенностями, которые легко упустить в официальном описании.
Частые ошибки - симптом и причина, а не общее предупреждение.
Частые вопросы и связанные темы - короткие переходы к соседним статьям без необходимости искать их заново.
Первоисточники - ссылки на docs.1c-bitrix.ru, dev.1c-bitrix.ru и учебные курсы, на которые опирается статья, чтобы можно было проверить факты и углубиться.

Дата последнего обновления под каждой статьёй берётся из истории изменений репозитория, а не проставляется вручную - она честно показывает, когда текст в последний раз редактировали.

Кто ведёт справочник

Справочник веду я один: пишу и проверяю статьи, слежу за изменениями платформы и обновляю то, что устарело.

Здесь появятся имя, опыт работы с 1С-Битрикс и то, что стоит знать о моей практике - этот абзац намеренно оставлен заготовкой до момента, когда я заполню его сам.

Как сообщить об ошибке

Если в статье что-то не совпадает с поведением платформы, устарело или описано неточно - самый полезный отчёт содержит адрес страницы, версию платформы (если она важна для расхождения) и то, что именно не сходится: какой код выполнялся и что получилось вместо ожидаемого.

Способ связи - email или форма обратной связи - появится здесь же, как только будет готов.