Refactor: scheduler: best practices for is_child_compatible()

Rename is_child_compatible() to pcmk__instance_is_compatible(), declare in
library-private header, use bool instead of gboolean, and improve log messages,
variable names, and formatting.