Auto merge of #18011 - Wilfred:op_queue_doc_comments, r=Veykril

internal: Add doc comments to OpQueue

I spent a while debugging some OpQueue behaviours and found the API slightly confusing, so I've added doc comments to clarify what each OpQueue method does.

Author: bors