kernel/thread: Expand documentation of nominal_priority and current_priority

Aims to disambiguate why each priority instance exists a little bit.
While we're at it, also add an explanatory comment to UpdatePriority().