Refactor: scheduler: best practices when adding probe restart orderings

Rename order_first_probe_then_restart_repromote() to
add_restart_orderings_for_probe(), add a doxygen block, improve comments and
log messages, and tweak formatting.