Explain priority order in javadocs

[Earthcomputer]

It's an easier quick reference than the wiki, if you forget the order.

[Mumfrey]

Yep. It's clear from some of the questions we get in IRC that it's not as obvious as I thought it was. I'll do a basic explanation now but also pencil in to make a more extensive documentation article explaining what it's for and general patterns for usage.