Refactor: scheduler: best practices when sorting resources

Rename sort_rsc_process_order() to cmp_resources(), add a doxygen block, and
improve comments and formatting. Also rename sort_resources() to
pcmk__sort_resources().