Set expected priority sort order

[vilsbole]

The docs state that Higher priorities are favoured over lower priorities.
Set the correct sort order for priority.

If accepted I'm happy to setup and include tests.

[ricmoo]

Rather than change code which might affect users, I will update the docs. :)

[ricmoo]

This has been fixed and published in the documentation. I see now the issue is that "higher priority" means a lower number (it can mean either, depending on the situation, but in my head that's how it works). So I've used the term "lower-value" and "higher-value" rather than the word priority to avoid any confusion at all.

Thanks! :)