documentation for priority handling