Refactor: scheduler: best practices for distribute_children()

Rename distribute_children() to pcmk__assign_instances(), add a doxygen block,
drop a redundant argument, use "assign" instead of "allocate" terminology,
and improve variable names, log messages, comments, and formatting.