Refactor: scheduler: best practices when scheduling probes

Rename probe_resources() to pcmk__schedule_probes(), make library-private,
add a doxygen block, and improve comments, formatting, and variable names.