tests: kernel: interrupt: Explain Cortex-M nested interrupt priorities

This commit adds an explanation comment for the interrupt priorities
used by the Cortex-M nested interrupt test.

Signed-off-by: Stephanos Ioannidis <root@stephanos.io>