Refactor: scheduler: best practices for find_compatible_child()

Rename find_compatible_child() to pcmk__find_compatible_instance(),
declare in library-private header, add a doxygen block, use bool instead of
gboolean, and improve log messages, variable names, comments, and formatting.