Refactor: scheduler: best practices for DeleteRsc()

Rename DeleteRsc() to pcmk__schedule_cleanup(), declare in library-private
header, drop a redundant argument, add a doxygen block, use bool instead of
gboolean, and improve log messages, comments, and formatting.