Refactor: scheduler: best practices when checking nodes availability

Rename can_run_any() to pcmk__any_node_available(), add a doxygen block, and
make it return bool instead of gboolean.