Я конечно новичок в этом деле, но тоже считаю, что документация требует серьезной доработки. Разумеется всего не охватить, но, пару примеров.
1. Делал рассылку на своем сайте.
В руководстве, насколько помню на странице 13:
...
Страница рассылок будет иметь следующий вид:
У меня после проведенных манипуляций:
В дальнейшем по этому вопросу получил ответ "главное - функционально всё работает
А внешний вид - настраивайте как хотите". Пусть так, но почему об этом не написать? Я лично растерялся и 2 дня разбирался что же не так делаю...
2. Или же при создании форума была проблема - не подключался шаблон компонента. Да, нашел позже ответ - в шаблоне не хватало <?$APPLICATION->ShowCSS();?>. И не спорю, в шаблоне про интеграцию об этом написано, но в других руководствах - ни слова. Тут проблема в том, что зачастую приходится работать с готовым сайтом, а не со своим, созданным с нуля. Может какой нибудь небольшой FAQ в руководствах разместить, по наиболее частым вопросам. Вон их на форуме сколько.
В заключении скажу, что никого не обвиняю - самому следует много научиться прежде чем советовать другим. Просто мое скромное мнение, как я вижу ситуацию со своей колокольни, с высоты обычного пользователя.