Документация ОЧЕНЬ сильно устарела, многое не описано, структура модулей и решений оставляет желать лучшего, в описании АПИ не указаны некоторые параметры. Порой очень много времени уходит на поиск нужных функций в коде самого Битрикса. Часть АПИ вообще не описана.
Хотя хорошу документацию, да, хочется.