Refactor: scheduler: best practices for parent_node_instance()

Rename parent_node_instance() to pcmk__top_allowed_node() to be somewhat
clearer about its purpose and follow current guidelines.

Also, move it to pcmk_sched_nodes.c, add a doxygen block, and declare it
library-private.