added some documentation for the new scroll related API changes