Порой добавляется интересная возможность, а в документации это лишь пара строчек в середине текста.
Например SECTION_SCOPE в CIBlockElement::GetList.
В принципе это есть в описаниях обновлений, но как часто их читают?
Хорошо бы иметь changelog для страниц документации api. Тогда сразу видны новые возможности.