Finally!
Завезли новую документацию по гридам в БУС:
https://dev.1c-bitrix.ru/api_d7/bitrix/main/systemcomponents/gridandfilter/mainuigrid/index.php

Если там не понятно - спрашивайте тут, мы активно используем гриды на проектах!