Refactor: scheduler: best practices when checking for insufficient capacity

Rename process_utilization() to pcmk__ban_insufficient_capacity(),
add a doxygen block, improve comments, and restructure to avoid a couple levels
of indent.