Refactor: scheduler: best practices when checking node availability

Rename can_run_resources() to pcmk__node_available(), add a doxygen block,
make it return bool instead of boolean, and drop a not particularly helpful
trace log so we can simplify it.