Fix IScalingScheduleCollection docs

This has numerous minor cleanups and removes a reference to a nonexistent parameter.