Document PriorityQueue.

Add examples to methods.
Could you put back-ticks around `capacity` (since it's explicitly referring to the parameter).