using lower number for higher priority
fix doc style (and a typo)