Refactor: scheduler: best practices when adding restart orderings for resource

Rename order_first_rsc_probes() to add_restart_orderings_for_rsc(), add a
doxygen block, improve comments, and tweak formatting and variable names.