Refactor: scheduler: best practices for function to assign a resource

Rename assign_node() to pcmk__assign_resource(), move to pcmk_sched_resource.c,
use bool instead of gboolean, declare in library-private header, and add a
doxygen block.