Есть раздел документации "Параметры компонента" https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=2132 в котором до сих пор ничего не говорится о возможности добавлять дополнительную переменную $arComponentParameters для добавления параметров шаблона.

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

Поэтому предлагаю:
1. Добавить описание переменной $arComponentParameters в документацию
2. Создать возможность добавления групп параметров из шаблона (Я уже не говорю о переопределении, а хотя бы добавление).

Создать логичную поэтапную документацию по Б24 для разработчиков. Не только сухое описание методов и курс по написанию приложений ( "При чём тут вообще приложения?" - спросит начинающий), а именно поэтапная документация (без разжевывания основ), в которую будут включены:

1. Основы архитектуры.
2. Отличие от БУС, особенности.
3. Методы разработки
4. Примеры решения типовых задач.
и т.п.

Прописать в документации на самом видном месте и несколько раз, что при использовании стандартных модулей обмена товарами между 1С и Битрикс товары никак не смогут быть выгружены в качестве торговых предложений, если в 1С номенклатура забита как обычные товары, а не как товары с характеристиками.

Для меня всегда было загадкой, как же 1С понимает, как делить товары на торговые предложения. Ну нигде не встречалась мне эта информация, пока не поставили вопрос ребром. Подавляющее большинство сайтов использует простые товары, без торговых предложений. Пару часов поиска (довольно неоднозначного, и всё встало на свои места).

Всё оказалось просто. В 1С есть обычная номенклатура и номенклатура с характеристиками. В первом случае вам никак не удастся выгрузить товары на сайт в качестве торговых предложений без дополнительного допиливания модуля обмена или изобретения обходных путей. Однако такой простой истины, на мой взгляд, нигде в документации не прописано.

Сегодня техподдержка официально подтвердила этот момент.

В конце страницы урока, например:

http://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2803

Есть ссылка "Развернуть комментарии" - которая показывается даже если комментариев нет.
Это запутывает - чтобы узнать, есть ли комментарии, нужно щёлкнуть по этой ссылке.

Нужно добавить однозначное сообщение (например, "Комментариев пока нет") о том, что комментарии отсутствуют. И ссылку для разворачивания комментариев в этом случае не показывать.

Было бы неплохо расширить разделы документации и курсов.
Допустим есть функционал, не суть важно насколько он новый, но в документации нет детального описания работы с ним и его настройки, нет подробного описания его возможностей и ограничений.
Пример из свежего..
CRM + 1С: есть только инструкция по подключению и запись в блоге что возможно сделать при данной интеграции, но всё описано довольно поверхностно. Без нюансов и деталей с которыми часто можно столкнуться, и многие, очень многие заваливают вопросами отдел поддержки или пишут вопросы в блог, спрашивают друг друга..  
К сожалению, даже по прошествии многих месяцев нет возможности открыть документацию и прочесть пусть собранную по крупицам но столь полезную информацию. Партнерам приходится вести собственную документацию по продуктам Битрикса, клиентам задавать вопросы направо и налево.. и порой ждать ответа месяцами.
Возможно даже партнерам стоит поделится подобной информацией что бы Битрикс свел это в одно целое. Как думаете?

Часто хочется просто отблагодарить тех кто размещает рабочие примеры в Пользовательских комментариях но такой возможности нет.
Рейтинг примеров в комментариях может также показывать и популярность или корректность этих примеров.