SI-8624 PriorityQueue documentation is not clear enough

Added a paragraph explaining that dequeue is the only way to get your elements in priority order.
Merge pull request #4020 from Ichoran/issue/8624

SI-8624 PriorityQueue documentation is not clear enough