added scheduleByStop

improved docs
improved consistency