Refactor: scheduler: best practices for PromoteRsc()

Rename PromoteRsc() to promote_resource(), add a doxygen block, use bool
instead of gboolean, and improve log messages, variable names, comments, and
formatting.