Refactor: scheduler: best practices when ordering instance demotion

Rename child_demoting_constraints() to order_instance_demotion() for
readability, add a doxygen block, and improve comments, log messages, and
formatting.