Global: Improve getMaxScrollForTransition definition and usage docs

Fixes gh-274