Refactor: scheduler: best practices for pcmk__order_migration_equivalents()

... and a static function it uses. Drop a redundant argument, improve the
doxygen block and other comments, and use case-sensitive comparisons for action
names.