Global: Improve getMaxScrollForTransition definition and usage docs

Fixes gh-274
Global: Improved wording