[b]Антон [/b] качественная документация действительно большая редкость, также как и хорошие технические писатели.
Но , судя по информации на сайте, в Битриксе этиму вопросу уделяют не последнее место.
Думаю, пора уже разработчикам Битрикса подумать о хорошем подробном руководстве разработчика , где была бы детально отражена архитектура системы и даны более подробные методики и советы по разработке проектов на базе платформы-Битрикс. Н-р, по 1с уже есть подобные книги.
Но повторюсь, что у многих и этого нет.