Refactor: scheduler: best practices when summing resources' utilization

Rename sum_unallocated_utilization() to sum_resource_utilization(), add a
doxygen block, rename arguments and variables for clarity, and tweak
formatting.

This also avoids copying a list by moving a small part of the function to its
sole caller.