Refactor: scheduler: best practices when updating node capacities

Replace calculate_utilization() with two functions
pcmkconsume_node_capacity() and pcmkrelease_node_capacity(), for
readability.

Also add doxygen blocks, and simplify a bit.