Документация одновременно с обновлениями.

Сегодня столкнулся с неприятной ситуацией, когда после очередного "стабильного" обновления перестал работать код:

$res = CTasks::GetList(
                    Array("ID" => "ASC"),
                    Array(
                        "RESPONSIBLE_ID" => $userId,
                        "FORUM_ID" => $forumId
                    )
                );

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

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