Refactor: scheduler: best practices for apply_promoted_location()

Rename apply_promoted_location() to apply_promoted_locations() since it works
on a list, add a doxygen block, and improve variable names, log messages, and
formatting.